Hexo 基本設定：從零到部署上線
想用 Hexo 架部落格？整個流程其實半小時就能搞定，前提是你不要在 theme 選擇困難症上卡太久。
先講結論
Hexo 就是裝 Node.js → 裝 hexo-cli → hexo init → 改設定 → 部署。核心設定檔是 _config.yml，部署推薦用 GitHub Pages + hexo-deployer-git 插件。
為什麼選 Hexo？
在靜態網站產生器的世界裡，Hexo 的賣點很明確：快、簡單、社群大。靜態檔案不需要伺服器端處理，速度天生就快。theme 和 plugin 生態算是豐富（雖然品質參差不齊），而且天然適合 SEO。
但說實話，如果你現在才要開始，可能也值得看看 Quartz 這類更現代的選項。
安裝流程
先裝 Node.js 和 pnpm
這是前置條件，沒裝的話後面全都走不下去：
# macOS 用 Homebrew
brew install node
brew install pnpm裝 Hexo CLI 然後初始化
pnpm add -g hexo-cli
mkdir my-blog && cd my-blog
hexo init
pnpm install就這樣，你已經有一個能跑的部落格了。
核心設定：_config.yml
這個檔案控制你部落格的一切。最重要的幾個設定：
# 基本資訊
title: My Blog
subtitle: Welcome to my blog
description: 這是一個使用 Hexo 建立的部落格
author: 你的名字
language: zh-TW
# 網址設定
url: https://你的域名.com
root: /
permalink: :year/:month/:day/:title/permalink 的格式會直接影響你文章的 URL 結構。選定之後盡量不要改，不然所有舊連結都會壞掉，SEO 也會受影響。
常用指令速查
hexo clean # 清除暫存檔（改完設定一定要先跑這個）
hexo generate # 產生靜態檔案（簡寫 hexo g）
hexo server # 啟動本地預覽，http://localhost:4000
hexo deploy # 部署到遠端（簡寫 hexo d）
hexo new "標題" # 新增文章最常用的組合技：hexo clean && hexo g -d，清理 → 產生 → 部署一次搞定。
部署到 GitHub Pages
建 repo 和裝插件
在 GitHub 建一個 你的帳號.github.io 的 repo，然後裝部署插件：
pnpm add hexo-deployer-git設定 deploy
在 _config.yml 加上：
deploy:
type: git
repo: git@github.com:<你的帳號>/<你的repo>.git
branch: gh-pages如果 repo 名稱是 帳號.github.io，branch 要改成 main。
SSH 金鑰（如果還沒設過）
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa把 ~/.ssh/id_rsa.pub 的內容加到 GitHub SSH Keys 裡。
部署！
hexo clean && hexo g -d等幾分鐘後到 https://你的帳號.github.io/ 就能看到了。如果看到空白頁或 404，先檢查 _config.yml 的 url 和 root 設定是不是跟實際 URL 一致。
日常維護
三件事記住就好：改完設定先 hexo clean、定期 pnpm update 更新插件、原始碼要用 Git 做版本控制和備份。
進階設定（theme、plugin、SEO）在 下一篇。
安裝 Hexo 花了 5 分鐘，選 theme 花了 5 小時，前端工程師的日常。