https://blog.howar31.com/tags/migration/Recent content in Migration 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>https://blog.howar31.com/posts/vuepress-v1-to-v2-upgrade/Sun, 23 Nov 2025 00:00:00 +0000https://blog.howar31.com/posts/vuepress-v1-to-v2-upgrade/<p>使用 VuePress v1 架設 blog 好幾年了，我決定升級到 VuePress v2，主要是想用更現代的建置系統、更好的效能，還有更好的開發體驗。 VuePress v2 帶來了不少改進，包括 Vite 打包工具、Vue 3 支援、TypeScript 支援，還有更模組化的插件架構。</p> <p>這篇文章記錄了我從 VuePress v1 升級到 v2 的過程，包括遇到的問題和解決方法。</p> <h2 id="為什麼要升級">為什麼要升級？</h2> <p>VuePress v2 有幾個讓我想要升級的理由：</p> <ul> <li><strong>Vite 打包工具</strong> - 建置時間比 webpack 快很多，熱模組替換也更快</li> <li><strong>Vue 3 支援</strong> - 現代的 Composition API 和更好的效能</li> <li><strong>TypeScript 支援</strong> - 型別安全的配置和更好的 IDE 支援</li> <li><strong>模組化架構</strong> - 更好的插件系統和更靈活的客製化</li> <li><strong>效能改進</strong> - 優化的打包分割和更快的頁面載入</li> <li><strong>更好的開發體驗</strong> - 改進的錯誤訊息和除錯工具</li> </ul> <div class="hint-container tip"> <p class="hint-container-title"> <i class="fas fa-lightbulb" aria-hidden="true"></i> Tip </p> 寫這篇文章的時候，VuePress v2 還在 Release Candidate (RC) 階段 (v2.0.0-rc.26)，不過已經穩定到可以上 production 了。 官方 v2 正式版應該很快就會發布。 </div> <h2 id="環境">環境</h2> <p>升級時使用的環境：</p>