hexo教學

一份給 Hexo 使用者的終極常用指令速查表，涵蓋從建立文章到部署網站的完整流程。無論是新手還是老手，都能在這裡找到需要的指令，大幅提升部落格管理效率。

📝 核心工作流程：寫作與內容管理

1. 建立新文章 (Post)

當您要撰寫一篇新的部落格文章時，使用此指令。Hexo 會根據 scaffolds/post.md 模板，在 source/_posts 資料夾中自動建立一個包含預設 front-matter 的 Markdown 檔案。

1
2
3
4
hexo new "您的文章標題"

# 縮寫
hexo n "您的文章標題"

2. 建立新頁面 (Page)

如果您想建立一個獨立頁面，例如「關於我」或「作品集」，請使用 page 指令。它會在 source 資料夾下建立一個與頁面同名的資料夾及 index.md。

1
2
3
4
hexo new page "About"

# 縮寫
hexo n page "About"
  • 這會建立 source/About/index.md 檔案。
  • 獨立頁面預設不會出現在首頁文章列表中。

💻 本地開發流程：預覽與除錯

在將網站部署上線前，先在自己的電腦上預覽效果，是確保萬無一失的關鍵步驟。

1. 清除快取與舊檔案 (Clean)

在重新產生網站前，建議先執行此指令。它會刪除 public 資料夾和其它暫存檔案，避免因快取導致內容未更新。

1
2
3
4
hexo clean

# 縮寫
hexo cl

2. 產生靜態網站 (Generate)

將您撰寫的 Markdown 檔案 (.md)、主題設定與資源檔，轉換成瀏覽器可讀的 HTML, CSS, JS 等靜態檔案，並存放在 public 資料夾中。

1
2
3
4
hexo generate

# 縮寫
hexo g
  • 監看模式：hexo g --watch 或 hexo g -w，檔案有變動時會自動重新產生。

3. 啟動本地伺服器 (Server)

在本地電腦上啟動一個網站伺服器，讓您可以透過瀏覽器即時預覽部落格。

1
2
3
4
hexo server

# 縮寫
hexo s
  • 預設網址為 http://localhost:4000。
  • 在終端機中按下 Ctrl + C 可以停止伺服器。
  • 實用參數：
    • hexo s -p 5000：將埠號改為 5000。
    • hexo s -g：啟動伺服器前，先執行一次 hexo g，確保內容是最新。

⭐ 推薦的預覽組合指令

這是在本地寫作時最常用的指令，它會清除快取、重新產生檔案，並啟動伺服器。

1
hexo clean && hexo s -g

🚀 上線部署流程：發布到全世界

當您在本地預覽確認無誤後，就可以將網站部署到公開的網路上。

前提：請確保您已安裝部署工具，對於 GitHub Pages，最常用的是 hexo-deployer-git。若未安裝，請執行 npm install hexo-deployer-git --save。

1. 產生並部署 (Generate & Deploy)

這是最常用、最高效的部署指令，它會自動完成「產生靜態檔案」和「部署」兩個步驟。

1
2
3
4
hexo generate --deploy

# 縮寫 (超級常用！)
hexo g -d

2. 清除、產生並部署 (Clean, Generate & Deploy)

如果您想確保部署的是最乾淨、最新的版本，可以先執行 clean。

1
hexo clean && hexo g -d

這個指令將清除舊檔、產生新檔，最後部署上線，是發布文章最完整可靠的流程。

💾 備份管理流程：原始碼版本控制 (Git)

部署到 GitHub Pages 的是 public 資料夾內的靜態檔案，而您的文章原始碼、主題設定檔等才是部落格的命脈。強烈建議使用 Git 將整個專案備份到另一個私有的 GitHub 倉庫。

以下為標準的 Git 操作流程，非 Hexo 特定指令。

1. 將所有變更加入暫存区

1
git add .

2. 提交變更並附上訊息

為這次的修改下一個簡潔明瞭的標題。

1
git commit -m "feat: 新增 Hexo 指令大全文章"

feat: 是 Commitizen 規範，代表新功能。您也可以用 “新增文章：” 等自己看得懂的格式。

3. 推送到遠端倉庫

將本地的 commit 推送到 GitHub，完成備份。

1
2
# 將 main 替換成您的備份分支名稱 (可能是 master, source 等)
git push origin main

說些什麼吧！

waline