Hexo-博客部署与-Git-版本管理完全指南

本指南总结了您从零开始创建 Hexo 博客，解决配置问题，并最终实现双仓库（Source + Pages）分离管理的全部流程。

环境准备与 Hexo 初始化#

在开始之前，确保您的电脑上已安装 Node.js 和 Git。

1. 全局安装 Hexo 命令行工具 (CLI)：

   PRTCL // BASH

   1
   npm install -g hexo-cli

   COPY

   • 如果出现报错提示,请使用命令提权 (Linux 系统可以忽略这个步骤 )

     PRTCL // SHELL

     1
     Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

     COPY

2. 创建博客文件夹并初始化项目： （假设新目录为 C:\Users\EchoWang\Documents\WEb\EchoSpace）

   PRTCL // BASH

   1
   # 切换到目标目录
   2
   cd C:\Users\EchoWang\Documents\WEb\
   3
   
   4
   # 创建并初始化 Hexo 项目
   5
   hexo init EchoSpace
   6
   cd EchoSpace  #进入根目录
   7
   
   8
   # 安装本地依赖
   9
   npm install

   COPY

3. 安装部署插件：

   PRTCL // BASH

   1
   npm install hexo-deployer-git --save

   COPY

站点配置与部署（Pages 仓库）#

这一步配置 Hexo 如何生成和部署您的网站到 GitHub Pages 仓库 ( 这里是我的域名blog.echospace.top)。

1. 配置站点文件_config.yml：

   打开博客根目录下的_config.yml，修改基本信息和部署设置。

   PRTCL // YAML

   1
   # URL ( 确保正确配置 )
   2
   url: https://blog.echospace.top
   3
   root: /
   4
   
   5
   # 主题设置 ( 使用您最终选择的主题，例如 next)
   6
   theme: next
   7
   
   8
   # 部署设置 ( 部署到您的 Pages 仓库 )
   9
   deploy:
   10
     type: git
   11
     repo: git@github.com:EchoSnake/echospace.github.io.git
   12
     #这里替换为你自己的仓库,建议使用 ssh 进行链接，更加安全
   13
     branch: main # 或 gh-pages

   COPY

2. 解决主题配置冲突（若遇到）：

   • 如果遇到 Cannot read properties of undefined 错误，请在主题配置文件中配置或禁用对应的功能块（如 donate 或 comment）。

   • 如果使用 Git 安装 NexT 等主题，请在 themes/next/_config.yml 中进行配置。

3. 部署上线测试：

   PRTCL // BASH

   1
   hexo clean
   2
   hexo generate
   3
   hexo deploy

   COPY

   （hexo deploy 会将 public/ 文件夹的内容推送到您的 Pages 仓库。）

源代码管理（Source 仓库）#

这一步将您的 Hexo 源代码 (.md 文件、_config.yml 等 ) 推送到您的源代码仓库 echospace-source.git。

1. 创建 .gitignore 文件（关键步骤）：

   在博客根目录 EchoSpace 下创建 .gitignore 文件，防止推送生成文件和依赖。

   PRTCL // SHELL

   1
   # 必须忽略的文件和文件夹
   2
   node_modules/
   3
   public/
   4
   db.json
   5
   .deploy*/
   6
   # ...其他配置...

   COPY

2. 初始化本地 Git 仓库并提交：

   PRTCL // BASH

   1
   git init
   2
   git add .
   3
   git commit -m "Initial commit for Hexo source files"

   COPY

3. 连接并推送到您的 Source 仓库：

   PRTCL // BASH

   1
   # 移除旧的远程仓库（如果存在）
   2
   git remote remove origin
   3
   
   4
   # 连接到您的 Source 仓库
   5
   git remote add origin https://github.com/EchoSnake/echospace-source.git
   6
   
   7
   # 推送源代码
   8
   git branch -M main
   9
   git push -u origin main

   COPY

VS Code 代码管理工作流#

在 VS Code 中，您主要进行写作和源代码的备份管理。

异地工作恢复（在新电脑上）#

在新电脑上继续工作时，您只需执行以下步骤：

1. 安装 Node.js, Git, hexo-cli。

2. 克隆源代码：git clone https://github.com/EchoSnake/echospace-source.git

3. 进入目录并恢复依赖：npm install

4. 开始工作。

作者：EchoWang

小红书：汪多多是只猫

B 站：汪多多是只猫

公众号：汪多多是只猫

博客：https://blog.echospace.top