https://blog.task4233.dev/tags/vitepress/Recent content in VitePress on noteHugoja-JP©task4233Mon, 11 May 2026 03:05:33 +0900https://blog.task4233.dev/posts/migrate-vuepress-to-vitepress/Mon, 11 May 2026 03:05:33 +0900https://blog.task4233.dev/posts/migrate-vuepress-to-vitepress/<h2 id="はじめに">はじめに</h2> <p><a href="https://task4233.dev/">task4233.dev</a> はもともと <strong>VuePress 1.x</strong> で運用していたポートフォリオ兼テックブログだった。テックブログとしての利用はすでに別ドメインへ移しており、本ドメインは実質的にプロフィールページとしてしか使っていなかった。</p> <p>そのまま放置していたが、ここ最近の状況がよろしくなかった:</p> <ul> <li>VuePress 1 系の最終リリースは <strong>2023-08</strong>（執筆時点で 2 年以上前）</li> <li>ビルドに <code>NODE_OPTIONS='--openssl-legacy-provider'</code> が必須（modern Node との非互換）</li> <li>Dependabot 経由の transitive 脆弱性 PR が定期的に降ってくる（webpack 4 世代の依存ツリー）</li> <li>そして決定打、<strong>自動デプロイが 2023-01-06 から止まっていた</strong>ことが調査して判明した</li> </ul> <p>腰を据えて移行することにした。スコープは <strong>トップページのみ</strong>（プロフィール／Publications／Employments 等を載せたシングルページ）。記事は別ドメインに集約済みなので、本ドメイン側に残っていた旧記事群はこの機会に撤去することとし、移行対象から最初から外した。</p> <p>同じような VuePress 1 サイトを抱えている人の参考になれば。</p> <h2 id="なぜ-vuepress-2-にしなかったのか">なぜ VuePress 2 にしなかったのか</h2> <p>最初に検討するべきは「VuePress 2 へのアップグレード」だ。同じ系統で済むなら、それが一番楽に見える。</p> <p>しかし、VuePress 2 は npm の <code>next</code> タグで RC が長期間配信されているだけで、執筆時点でも GA に到達していない。さらに調査を進めると、v1 → v2 は <strong>アップグレードではなく実質書き直し</strong>であることが分かった:</p> <ul> <li><strong>Vue 2 → Vue 3</strong> のメジャーアップ（カスタムコンポーネントに手が入っているなら全書き直し）</li> <li>設定ファイルは <strong>CommonJS → ESM 必須</strong></li> <li>バンドラーが暗黙ロードでなくなり、<code>@vuepress/bundler-vite</code> 等を明示的に install</li> <li>プラグイン参照が文字列指定不可、<code>import</code> した関数を渡す形式に</li> </ul> <p>加えて、私のサイトはデフォルトテーマを <code>eject</code> してアクセント色を変えていた。v2 ではこの ejected theme が完全に無効化されるため、<strong>カスタマイズ部分は丸ごと書き直し</strong>になる。</p>