在數字時代，擁有一個個人博客是展示技術、分享知識和記錄生活的好方法。使用Node.js、Hexo靜態博客框架和GitHub Pages服務，你可以免費、快速且靈活地搭建一個屬于自己的博客網站。本文將詳細介紹從零開始搭建博客的完整步驟。
一、準備工作
在開始之前，你需要準備好以下幾樣東西：
- 安裝Node.js和npm：Hexo基于Node.js，因此首先需要訪問Node.js官網下載并安裝最新穩定版。安裝Node.js時會自動包含npm（Node包管理器）。安裝完成后，可以在命令行輸入
node -v和npm -v來驗證安裝是否成功。 - 安裝Git：用于版本控制和將博客部署到GitHub。從Git官網下載并安裝。安裝后，同樣可以使用
git --version命令檢查。 - 注冊GitHub賬號：如果你還沒有，請前往GitHub官網注冊一個免費賬號。
二、安裝并初始化Hexo
打開命令行（終端），執行以下命令全局安裝Hexo命令行工具：`bash
npm install -g hexo-cli`
安裝完成后，選擇一個你喜歡的目錄（例如 D:\MyBlog），在該目錄下初始化你的博客項目：`bash
hexo init myBlog # myBlog是你的博客文件夾名
cd myBlog
npm install # 安裝依賴包`
此時，一個基本的Hexo博客就生成了。你可以運行 hexo server（或簡寫 hexo s）啟動本地服務器，然后在瀏覽器中訪問 http://localhost:4000 查看默認的博客效果。
三、配置博客基本信息
博客的核心配置文件是根目錄下的 _config.yml 文件。用文本編輯器打開它，你需要修改一些關鍵設置：
title： 你的博客標題。subtitle： 副標題。description： 博客描述。author： 你的名字。language： 語言（如zh-CN）。url： 你的網站最終域名（可以先不修改，部署到GitHub后再設置）。
四、創建GitHub倉庫并配置部署
1. 創建倉庫：登錄GitHub，點擊右上角“+”號，選擇“New repository”。倉庫名必須嚴格遵循格式：你的用戶名.github.io（例如，如果你的用戶名是zhangsan，則倉庫名為 zhangsan.github.io）。選擇“Public”，然后點擊“Create repository”。
2. 安裝部署插件：在博客文件夾根目錄下，運行命令安裝Hexo的Git部署插件：`bash
npm install hexo-deployer-git --save`
3. 配置部署信息：再次編輯 _config.yml 文件，找到末尾的 deploy 部分，修改為：`yaml
deploy:
type: git
repo: https://github.com/你的用戶名/你的用戶名.github.io.git # 你的倉庫HTTPS地址
branch: main # 或 master，取決于你的倉庫默認分支名
message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}" # 可選的提交信息`
五、撰寫博文與本地測試
- 新建文章：在命令行中運行
hexo new "我的第一篇文章"，Hexo會在source/_posts目錄下生成一個Markdown文件。你可以用任何Markdown編輯器編輯這個文件。 - 生成靜態文件：運行
hexo generate（或hexo g）將文章和主題編譯成靜態HTML文件。 - 本地預覽：運行
hexo server，在本地4000端口預覽博客，確保一切正常。
六、部署到GitHub Pages
當一切準備就緒，執行部署命令：`bash
hexo deploy # 或 hexo d`
首次部署可能會要求你輸入GitHub的用戶名和密碼（現在通常需要使用Personal Access Token代替密碼，可在GitHub設置中生成）。
部署完成后，等待大約1-2分鐘，然后在瀏覽器中訪問 https://你的用戶名.github.io，你就能看到自己在線上的博客了！
七、后續維護與進階
- 更新博客：以后每次寫完新文章，只需重復
hexo clean（清理緩存）、hexo g、hexo d這個流程即可。 - 更換主題：Hexo有豐富的主題庫。你可以訪問Hexo官網的主題頁面，選擇喜歡的主題，按照其說明文檔進行安裝和配置。
- 綁定自定義域名：如果你有自己的域名，可以在倉庫的“Settings” -> “Pages”里設置Custom domain，并在域名服務商處添加CNAME記錄。
- 使用源碼分支：一個更專業的做法是創建兩個分支，例如用
main分支存放編譯后的靜態文件（用于GitHub Pages展示），用source分支存放你的Hexo源碼（包括文章、主題和配置），這樣便于備份和管理。
通過以上步驟，你已經成功搭建了一個快速、安全且完全由自己掌控的靜態博客。盡情地書寫你的想法，與世界分享吧！
