本指南总结了您从零开始创建 Hexo 博客，解决配置问题，并最终实现双仓库（Source + Pages）分离管理的全部流程。
一、环境准备与 Hexo 初始化
在开始之前，确保您的电脑上已安装 Node.js 和 Git。
全局安装 Hexo 命令行工具 (CLI)：
npm install -g hexo-cli创建博客文件夹并初始化项目：
（假设新目录为 C:\Users\EchoWang\Documents\WEb\EchoSpace）# 切换到目标目录 cd C:\Users\EchoWang\Documents\WEb\ # 创建并初始化 Hexo 项目 hexo init EchoSpace cd EchoSpace #进入根目录 # 安装本地依赖 npm install安装部署插件：
npm install hexo-deployer-git --save
二、站点配置与部署（Pages 仓库）
这一步配置 Hexo 如何生成和部署您的网站到 GitHub Pages 仓库 (这里是我的域名blog.echospace.top)。
配置站点文件
_config.yml：打开博客根目录下的
_config.yml，修改基本信息和部署设置。# URL (确保正确配置) url: https://blog.echospace.top root: / # 主题设置 (使用您最终选择的主题，例如 next) theme: next # 部署设置 (部署到您的 Pages 仓库) deploy: type: git repo: [email protected]:EchoSnake/echospace.github.io.git #这里替换为你自己的仓库,建议使用ssh进行链接，更加安全 branch: main # 或 gh-pages解决主题配置冲突（若遇到）：
如果遇到
Cannot read properties of undefined错误，请在主题配置文件中配置或禁用对应的功能块（如donate或comment）。如果使用 Git 安装 NexT 等主题，请在
themes/next/_config.yml中进行配置。
部署上线测试：
hexo clean hexo generate hexo deploy（
hexo deploy会将public/文件夹的内容推送到您的 Pages 仓库。）
三、源代码管理（Source 仓库）
这一步将您的 Hexo 源代码 (.md 文件、_config.yml 等) 推送到您的源代码仓库 echospace-source.git。
创建 .gitignore 文件（关键步骤）：
在博客根目录 EchoSpace 下创建 .gitignore 文件，防止推送生成文件和依赖。
# 必须忽略的文件和文件夹 node_modules/ public/ db.json .deploy*/ # ...其他配置...初始化本地 Git 仓库并提交：
git init git add . git commit -m "Initial commit for Hexo source files"连接并推送到您的 Source 仓库：
# 移除旧的远程仓库（如果存在） git remote remove origin # 连接到您的 Source 仓库 git remote add origin https://github.com/EchoSnake/echospace-source.git # 推送源代码 git branch -M main git push -u origin main
四、VS Code 代码管理工作流
在 VS Code 中，您主要进行写作和源代码的备份管理。
| 操作目的 | 对应工具 / 命令 | 目标仓库 |
|---|---|---|
| 写作/配置修改 | VS Code 编辑器 | 本地文件 |
| 备份源代码 | VS Code 源代码管理 (提交 $\rightarrow$ 推送) | echospace-source.git |
| 网站更新上线 | PowerShell: hexo deploy |
echospace.github.io.git |
异地工作恢复（在新电脑上）
在新电脑上继续工作时，您只需执行以下步骤：
安装 Node.js, Git,
hexo-cli。克隆源代码：
git clone https://github.com/EchoSnake/echospace-source.git进入目录并恢复依赖：
npm install开始工作。
关于我
全平台同名”汪多多是只猫”，专注分享实用开源工具，让你的数字生活更自由！
关注我，发现更多旧物改造的乐趣与技巧！
