个人博客网站搭建

网站搭建教程

• 参考教程从零开始搭建属于你自己的博客（GitHub Pages+Hexo)

常用命令

• 总结，涵盖博客开发、写作、部署等全流程操作：

1. 初始化与安装

命令	说明
hexo init <folder>	初始化 Hexo 博客项目（默认生成 _config.yml）
npm install hexo-cli -g	全局安装 Hexo 命令行工具
npm install	安装 package.json 中的依赖（首次克隆项目后必运行）

2. 本地开发与调试

命令	说明
hexo server 或 hexo s	启动本地服务器（默认 http://localhost:4000）
hexo s --debug	启用调试模式（显示详细日志）
hexo s -p 5000	指定端口（如 5000）运行服务器

3. 内容创作与管理

命令	说明
hexo new "文章标题" 或 hexo n	创建新文章（在 source/_posts/ 下生成 .md 文件）
hexo new page "关于"	创建新页面（如 source/about/index.md）
hexo publish <filename>	发布草稿（从 _drafts/ 移动到 _posts/）

4. 生成静态文件

命令	说明
hexo generate 或 hexo g	生成静态文件到 public/ 目录
hexo g --watch	监听文件变动并自动重新生成
hexo clean	清除缓存和已生成的 public/ 文件夹

5. 部署到远程

命令	说明
hexo deploy 或 hexo d	部署到 _config.yml 中配置的远程仓库
hexo g -d 或 hexo d -g	生成静态文件并立即部署（最常用）
hexo clean && hexo g -d	彻底清理后重新生成并部署

6. 插件与主题管理

命令	说明
npm install hexo-plugin-name --save	安装 Hexo 插件（如 hexo-deployer-git）
git clone <theme-url> themes/主题名	手动安装主题
npm update	更新所有依赖插件

7. 实用技巧

（1）自定义文章模板

1. 在 scaffolds/ 下创建自定义模板（如 post.md）。
2. 新建文章时指定模板：

   hexo new "标题" --layout post

（2）多设备同步

git clone <你的博客仓库> && npm install

（3）调试部署问题

hexo d --debug  # 显示详细部署日志

常见问题速查

问题	解决命令
本地更改未生效	hexo clean && hexo g
部署失败（权限错误）	检查 _config.yml 的 repo 配置为 SSH/HTTPS
主题样式丢失	确保主题文件夹存在且 _config.yml 中 theme: 名称正确