hexo教學

當您更換電腦或重灌系統後，如何快速還原您的 Hexo 部落格？本教學將引導您利用先前在 GitHub 上的原始碼備份，在新環境中完美重建所有內容。

在上一篇 備份教學 中，我們學會了如何將 Hexo 專案的原始碼完整備份到一個私有的 GitHub 倉庫。現在，我們將利用這個備份，來示範如何在一個全新的環境中，從零開始，將您的部落格完整還原。

第一步：安裝基礎開發環境

無論在哪台電腦上，要運行 Hexo，我們都需要 Node.js（執行環境）、Git（版本控制工具）以及 Hexo CLI（命令列工具）。

1. 安裝 Node.js 與 Git

  • Node.js: 前往 Node.js 官網 下載並安裝 LTS (長期支援) 版本，這是最穩定且推薦的版本。
  • Git: 前往 Git 官網 下載並安裝適合您作業系統的版本。

安裝完畢後，開啟您的終端機（Terminal、命令提示字元或 PowerShell），輸入以下指令來確認是否安裝成功。如果能成功顯示版本號，代表安裝無誤。

1
2
3
node -v
npm -v
git --version

提示：在新電腦上，您需要重新設定 Git 與 GitHub 帳號的連接（例如設定 SSH 金鑰），這樣才能順利從您的私有倉庫 clone 或 push。詳細步驟可參考 GitHub 官方文件。

2. 全域安裝 Hexo CLI

Hexo CLI 是操作 Hexo 部落格的核心工具。在終端機中，輸入以下指令來進行全域安裝，這樣您在任何路徑下都能使用 hexo 指令。

1
npm install -g hexo-cli

同樣地，使用 hexo -v 來確認是否成功安裝。

第二步：從 GitHub 下載（Clone）部落格原始碼

基礎環境準備就緒後，現在我們要將備份在 GitHub 上的原始碼下載到新電腦。

  1. 前往您備份用的私有倉庫 GitHub 頁面。

  2. 點擊綠色的 “<> Code” 按鈕，複製倉庫的 URL（建議使用 SSH 或 HTTPS）。

  3. 開啟終端機，切換到您想要存放部落格專案的資料夾，然後執行 git clone 指令：

1
2
# 將 [你的倉庫URL] 替換成上一步複製的網址
git clone [你的倉庫URL]

分支說明：在上一篇教學中，我們是將程式碼推送到 master 或 main 分支。如果您的備份分支有特殊名稱（例如 source 或 dev），您需要使用 -b 參數來指定分支，例如：
git clone -b source [你的倉庫URL]

執行完畢後，Git 會將您的整個專案下載到一個與倉庫同名的資料夾中。

第三步：安裝專案相依套件

原始碼雖然下載下來了，但還缺少運作時所需的各種套件（例如主題、渲染器、部署工具等）。這些套件的資訊都記錄在 package.json 檔案中。

1. 首先，使用 cd 指令進入剛剛 clone 下來的專案資料夾：

1
2
# 將 [專案資料夾名稱] 換成你自己的
cd [專案資料夾名稱]

2. 接著，執行 npm install 來安裝所有相依套件：

1
npm install

提示：npm 會讀取 package.json 與 package-lock.json 檔案，下載並安裝所有被記錄下來的、版本完全相同的套件，確保新環境與舊環境的依賴關係一致。

第四步：啟動預覽與部署發布

恭喜！您的部落格至此已完全還原。現在來驗證一下成果吧。

1. 在本機啟動預覽伺服器：

在專案資料夾中執行以下指令：

1
2
3
hexo server
# 或簡寫
hexo s

終端機將顯示服務已啟動。此時在瀏覽器中開啟 http://localhost:4000，您應該能看到與舊電腦上完全一樣的部落格。

2. 產生靜態檔案並部署到網站：

確認本機預覽無誤後，即可執行標準的部署指令，將部落格發布到您的 GitHub Pages 或其他託管平台。

1
2
3
hexo generate --deploy
# 或簡寫
hexo g -d

此指令會先清除舊的檔案、重新產生最新的靜態網站內容，然後將其部署到您在 _config.yml 中設定好的公開倉庫。

至此，您已經成功完成了整個部落格的無痛轉移與還原！

參考資料

說些什麼吧！

waline