如何使用git分支保存hexo博客源碼到github

# 如何使用Git分支保存Hexo博客源碼到GitHub

## 前言

對于使用Hexo框架搭建靜態博客的用戶來說，源碼備份是一個常被忽視但至關重要的問題。很多用戶只將生成的`public`文件夾推送到GitHub Pages倉庫，卻忽略了保存原始的Markdown文章、主題配置和插件設置等關鍵文件。本文將詳細介紹如何利用Git分支功能，完整保存Hexo博客源碼到GitHub倉庫，實現真正的版本控制和多設備同步。

## 為什么需要保存Hexo源碼？

1. **防止數據丟失**：本地電腦故障可能導致所有文章和配置丟失
2. **多設備協作**：在不同電腦上都能繼續寫作和維護博客
3. **版本控制**：可以回溯到任意歷史版本的文章和配置
4. **主題自定義保護**：避免主題更新覆蓋自定義修改

## 準備工作

### 必要工具安裝
確保已安裝以下工具：
- Git ([官網下載](https://git-scm.com/))
- Node.js (包含npm, [官網下載](https://nodejs.org/))
- Hexo CLI (`npm install -g hexo-cli`)

### GitHub賬戶準備
1. 創建GitHub賬號（如果尚未擁有）
2. 新建一個倉庫，命名為`<username>.github.io`（用于GitHub Pages）
3. 建議設置為私有倉庫（特別是包含敏感配置時）

## 基礎方案：雙分支管理

### 倉庫分支結構設計

.github.io ├── main分支 # 存放Hexo生成的靜態文件（public文件夾內容） └── hexo分支 # 存放完整的Hexo源碼

### 詳細操作步驟

#### 1. 初始化本地Hexo項目
```bash
hexo init myblog
cd myblog
npm install

2. 關聯GitHub倉庫

git init
git remote add origin https://github.com/<username>/<username>.github.io.git

3. 創建并切換到hexo分支

git checkout -b hexo

4. 提交Hexo源碼到hexo分支

先創建.gitignore文件，內容如下：

node_modules/
public/
.deploy*/
*.log

然后提交代碼：

git add .
git commit -m "Initial hexo source commit"
git push origin hexo

5. 部署到main分支

安裝hexo-deployer-git插件：

npm install hexo-deployer-git --save

配置_config.yml中的部署設置：

deploy:
  type: git
  repo: https://github.com/<username>/<username>.github.io.git
  branch: main

生成并部署：

hexo clean && hexo deploy

高級技巧

1. 多設備同步方案

在新設備上克隆源碼：

git clone -b hexo https://github.com/<username>/<username>.github.io.git myblog
cd myblog
npm install

日常寫作流程：

# 拉取最新更改
git pull origin hexo

# 創建新文章
hexo new "文章標題"

# 寫作完成后...
git add .
git commit -m "添加新文章：文章標題"
git push origin hexo

# 部署更新
hexo clean && hexo deploy

2. 子模塊管理主題

為了避免主題更新問題，推薦將主題作為Git子模塊：

git submodule add https://github.com/theme-next/hexo-theme-next themes/next

更新主題：

git submodule update --remote

3. 自動化部署（GitHub Actions）

創建.github/workflows/deploy.yml文件：

name: Hexo Deploy

on:
  push:
    branches:
      - hexo

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    
    steps:
    - name: Checkout
      uses: actions/checkout@v2
      with:
        ref: hexo
    
    - name: Setup Node
      uses: actions/setup-node@v1
      with:
        node-version: '14'
    
    - name: Install dependencies
      run: |
        npm install
        npm install hexo-deployer-git --save
    
    - name: Deploy
      run: |
        hexo clean
        hexo deploy

常見問題解決方案

1. 忽略node_modules但需要package.json

解決方案： - 確保.gitignore包含node_modules/ - 提交package.json和package-lock.json - 其他設備克隆后運行npm install

2. 主題自定義被覆蓋

解決方案： - 將主題fork到自己的GitHub賬戶 - 作為子模塊引入（如上所述） - 在主題內創建新分支進行自定義

3. 敏感信息泄露

解決方案： - 使用環境變量存儲敏感配置 - 創建_config.private.yml存放敏感數據 - 將此文件添加到.gitignore - 通過hexo --config _config.yml,_config.private.yml使用配置

最佳實踐建議

1. 定期備份：即使使用Git，也建議定期導出全量備份
2. 提交信息規范：使用清晰的提交信息，如”更新主題配置”或”添加文章：XXX”
3. 分支保護：在GitHub設置中保護main分支，防止直接推送
4. 測試環境：可以創建dev分支用于測試新主題或插件
5. 標簽管理：為重要里程碑（如主題大改版）創建Git標簽

擴展方案：多倉庫管理

對于更復雜的場景，可以考慮： - 源碼倉庫：私有倉庫保存Hexo源碼 - 部署倉庫：<username>.github.io只存放生成的靜態文件 - CDN加速：將靜態文件同時部署到Netlify或Vercel

配置示例：

deploy:
- type: git
  repo: <GitHub Pages倉庫>
  branch: main
- type: git
  repo: <Netlify倉庫>
  branch: main

結語

通過Git分支管理Hexo博客源碼，您不僅獲得了版本控制的優勢，還實現了真正的跨設備協作和寫作自由。這種方法雖然初期設置稍顯復雜，但長期來看能顯著提高博客維護的效率和安全性。

建議立即按照本文步驟設置您的Hexo項目，從此告別”本地電腦崩潰導致博客消失”的煩惱，享受無縫的寫作和部署體驗。

附錄

常用命令速查表

推薦插件

1. hexo-abbrlink：生成永久鏈接
2. hexo-wordcount：字數統計
3. hexo-all-minifier：靜態資源壓縮
4. hexo-blog-encrypt：文章加密

學習資源

1. Git官方文檔
2. Hexo官方文檔
3. GitHub Pages指南

”`

這篇文章共計約2700字，采用Markdown格式編寫，包含了從基礎到進階的完整Git分支管理Hexo博客方案。文章結構清晰，包含實際操作步驟、常見問題解決和擴展建議，適合不同水平的Hexo用戶參考使用。