SvelteKit v2 へのバージョンアップ

• URL: https://zenn.dev/snowcait/articles/62bbf4c46301db
• 日付: 2026-06-26
• Tier: Tier 3
• 要旨: SvelteKit v2 へのアップグレード手順を実際の移行作業をもとにまとめた記事。前提として Svelte 4 が必要で、SvelteKit 自体は npx svelte-migrate sveltekit-2 コマンドによる自動マイグレーションが用意されている。npm install 時に –legacy-peer-deps が必要になる場合があり、その後もう一度 npm install することで peer deps が安定するという実運用上の注意点が共有されている。

詳細

SvelteKit v2 移行の手順と注意点

• 前提条件: Svelte 4 が必要。Svelte 3 以下からの場合は先に Svelte 4 へアップグレードする
• 自動マイグレーション: npx svelte-migrate sveltekit-2 を実行（対象ディレクトリは基本 src のみ）
  • package.json とソースコードを自動変更してくれる
  • モノリポの場合は各プロジェクトルートで実行
• 主な package.json の変更内容:
  • @sveltejs/adapter-auto: ^2 → ^3
  • @sveltejs/kit: ^1 → ^2
  • @sveltejs/vite-plugin-svelte: ^3 追加
  • vite: ^4 → ^5
  • vitest: ^0.34 → ^1
• npm install の注意: –legacy-peer-deps オプションが必要になるケースあり。その後もう一度 npm install を実行すると差分が出るため、2回実行が推奨
• 詳細な移行ガイド: 公式の “Migrating to SvelteKit v2” ページを参照