[jekyll] 05 基本安裝 Jekyll 的流程及啟動

Jekyll 安裝與啟動：從 gem install 到 localhost:4000

Ruby 環境搞定了嗎？如果還沒，先去 第一篇 把 Ruby 裝好。裝好了就繼續。

先講結論

gem install jekyll bundler → jekyll new myblog → cd myblog → bundle install → bundle exec jekyll serve。五個指令，你的部落格就跑起來了。

安裝 Jekyll

gem install jekyll bundler

確認裝好了：

jekyll -v   # 應該顯示 jekyll 4.x.x

建立新站點

jekyll new myblog
cd myblog

jekyll new 會產生一個完整的起始專案。目錄結構長這樣：

myblog/
├── _posts/          # 文章放這裡（Markdown 格式）
├── _config.yml      # 設定檔（標題、網址、主題）
├── Gemfile          # Ruby 的 package.json
├── Gemfile.lock     # 鎖定版本
├── index.markdown   # 首頁
├── about.markdown   # 關於頁面
└── 404.html         # 404 頁面

最重要的是 _config.yml——站名、描述、主題都在這改。_posts/ 是放文章的地方，檔名格式必須是 YYYY-MM-DD-title.md，不照這個格式 Jekyll 不認。

安裝相依套件

bundle install

根據 Gemfile 安裝所有需要的 gem。第一次跑可能要等一下，之後就快了。

本地預覽

bundle exec jekyll serve

看到這個就表示成功了：

Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.

打開瀏覽器到 http://localhost:4000 就能看到你的網站。改了檔案存檔後重新整理就會更新。

加 --livereload 可以讓瀏覽器自動重新整理：bundle exec jekyll serve --livereload

建置正式版

bundle exec jekyll build

產出放在 _site/ 資料夾，裡面是純 HTML。丟到任何靜態主機（GitHub Pages、Netlify、Vercel）就能上線了。

常見問題

• port 4000 被占用：加 --port 4001 換個 port
• 改了 _config.yml 沒反應：設定檔的變更必須重啟 server，Ctrl+C 停掉再跑一次
• Gemfile 版本衝突：bundle update 讓 Bundler 重新解析
• Windows 編碼問題：_config.yml 加上 encoding: utf-8

---

裝 Jekyll 花了 5 分鐘，搞 Ruby 花了 50 分鐘。這就是為什麼第一篇要先講 Ruby。