https://blog.howar31.com/tags/hugo/Recent content in Hugo on Howar31 BlogHugozh-twWed, 22 Apr 2026 23:51:19 +0800https://blog.howar31.com/posts/vuepress-to-hugo-migration/Wed, 22 Apr 2026 00:00:00 +0000https://blog.howar31.com/posts/vuepress-to-hugo-migration/<h2 id="前言">前言</h2> <p>2025 年 11 月才剛從 VuePress v1.8 升上 v2.0.0-rc.26，本以為至少能安穩用個幾年。結果升完五個月就遇到一堆問題，最後在 2026 年 4 月決定<strong>再搬一次</strong>，這次換到 Hugo。</p> <p>這篇記錄從評估、選型、遷移、踩雷到最後部署上線的完整過程，順便也拿這篇當 component 測試文，把 Hugo 版型的 code block、tip、warning、表格、SVG、taxonomy 一次全部跑過。</p> <h2 id="為什麼升-v2-才-5-個月就要再搬">為什麼升 v2 才 5 個月就要再搬？</h2> <p>升級前以為是一次「大幅刷新但之後穩定」的投資。升完才真正理解現狀：</p> <ul> <li><strong>VuePress v2 本身自 2022 就卡在 RC</strong>，到 2026 仍然沒有 stable。這個「卡 RC 3+ 年」的背景是在<strong>升上去之後</strong>才有切身感受</li> <li><strong>插件生態沒跟上</strong>：v1 時期依賴的若干插件在 v2 沒有對應版本，有些甚至上游直接放棄維護</li> <li><strong>RC 階段的 theme API 仍會 breaking change</strong>：升 v2 時已經改了一次 theme，完全不想再因為某次 RC 升級又全部改一次</li> <li><strong>Dev server 啟動 30 秒</strong>：寫文章的摩擦大到開了就忘記要寫什麼</li> </ul> <p>與其繼續賭 v2 什麼時候脫 RC，不如直接換到<strong>生態穩定、建置極快</strong>的工具。於是評估了 Astro、Next.js、Eleventy、Hugo，最後選 Hugo：</p> <table> <thead> <tr> <th>候選</th> <th>建置速度</th> <th>生態穩定度</th> <th>Runtime 依賴</th> <th>主要缺點</th> </tr> </thead> <tbody> <tr> <td><strong>Hugo</strong></td> <td>極快（幾百毫秒）</td> <td>十年以上穩定</td> <td>Go binary</td> <td>模板語法較陌生</td> </tr> <tr> <td>Astro</td> <td>中等</td> <td>快速演進中</td> <td>Node.js</td> <td>還在 breaking changes</td> </tr> <tr> <td>Next.js</td> <td>慢（依頁面數成長）</td> <td>成熟但偏 App</td> <td>Node.js</td> <td>對靜態部落格 overkill</td> </tr> <tr> <td>Eleventy</td> <td>快</td> <td>小眾但穩定</td> <td>Node.js</td> <td>template 選擇多到雜亂</td> </tr> </tbody> </table> <p>Hugo 的勝出原因很簡單：<strong>Go 寫的單一執行檔、零 Node.js、零 npm、template 語法雖然怪但至少不會自己 breaking change</strong>。</p>