メインコンテンツへスキップ
#Web制作 約8分で読めます

Astro 7.0のRustコンパイラに乗り換えたら、ビルドは速くなったが先にHTMLを直す羽目になった

Astro 7.0のRustコンパイラ移行とVite 8統合でビルド速度がどう変わったか、既存プロジェクトで実際にアップグレードした記録

Astro 7.0が出たとき、最初に目に入ったのは「ビルド最大61%高速化」の数字だった。自分のブログはAstro 5系で動いていて、ページ数は100もないからビルド速度に不満はなかったが、Rustコンパイラへの切り替えとVite 8のRolldownバンドラという構成の変化が気になって、検証用のプロジェクトで試すことにした。

Goコンパイラが消えた

Astroのコンパイラは初期からGoで書かれ、WASMとして配布されていた。withastro/compilerのリポジトリにもそう書いてある。Astro 6.0でexperimental.rustCompilerとしてRust版が入り、7.0でそれがデフォルトになった。Go版は削除。

Rust版はoxcでパースし、CSS scopingにはLightning CSSを使う。ネイティブバイナリで配布され、対応していない環境にはWASMフォールバックがある。公式ブログによれば、コンパイラ単体での速度改善はdocs.astro.buildで約6%程度で、実はここだけだと劇的ではない。ビルド全体の高速化に効いているのは、むしろMarkdownパイプラインのRust化(Sätteri)とVite 8のRolldownの方が大きい。

アップグレードで最初にやるのはHTMLの修正

npx @astrojs/upgradeを叩けばパッケージは上がる。問題はその後のビルドだった。

旧Goコンパイラは閉じタグのないHTMLを黙って補正していた。Rust版はそれをやらない。閉じていないタグ、終端されていない属性はエラーになる。自分のプロジェクトでは<br>を<br />に直す程度で済んだが、コンポーネントの中で<p>タグを入れ子にしていた箇所が1つあって、旧コンパイラは勝手にDOM構造を組み替えて通していたらしい。Rust版ではそのまま壊れた。

アップグレードガイドにも書いてあるとおり、まずビルドを回して出たエラーを1つずつ潰すのが正攻法。テンプレートの品質が低いプロジェクトほど、ここで時間を取られる。

もうひとつ、ホワイトスペースの扱いが変わった。compressHTMLのデフォルトが'jsx'になり、インライン要素間の改行がスペースとして残らなくなる。ナビゲーションのリンク間にスペースを入れていた場合、意図しない詰まり方をする。明示的に{" "}を挟むか、CSSのgapで対処する。

Vite 8とRolldownの恩恵

Astro 7.0はVite 8を同梱している。Vite 8は2026年3月にリリースされ、最大の変更はバンドラがRolldownに統一されたこと。従来はdev時にesbuild、本番ビルドにRollupという二本立てだったが、Rolldownが両方を担う。Rustで書かれていて、公式の数字ではRollupの10〜30倍速いとされている。

Astro公式ブログに載っているベンチマークがわかりやすい。

サイトページ数v6v7改善率
docs.astro.build約6,300114.5s73.5s36%
astro.build約30062.7s24.2s61%
biomejs.dev約6,500176.4s149.9s15%
developers.cloudflare.com約8,400386.9s261.9s32%

astro.build(約300ページ)で61%の改善が出ている一方、biomejs.dev(約6,500ページ)は15%にとどまる。ページ数が多いからといって恩恵が大きいわけではなく、Markdownの構造やプラグインの数で差がつく印象。自分の100ページ弱の検証サイトでは体感で3割くらい速くなった気がするが、元が数秒の世界なので正直「わかる人にはわかる」程度。

Markdownパイプラインの入れ替え

地味に影響が大きいのがMarkdownプロセッサの変更。Astro 7.0ではSätteriがデフォルトになった。pulldown-cmarkでCommonMarkをパースし、MDXの式展開にはoxcを使う。remark/rehypeのJSパイプラインはSätteriに置き換えられた形になる。

remarkやrehypeのプラグインを使っているなら、2つの選択肢がある。

  1. Sätteriのプラグイン体系に移植する
  2. @astrojs/markdown-remarkを入れて旧パイプラインを維持する
// astro.config.mjs — 旧パイプラインを維持する場合
import { unified } from '@astrojs/markdown-remark';

export default defineConfig({
  markdown: {
    processor: unified({
      remarkPlugins: [/* 既存のプラグイン */],
      rehypePlugins: [/* 既存のプラグイン */],
    }),
  },
});

自分はremark-reading-timeくらいしか使っていなかったので、Sätteriのままで問題なかった。ただし、remarkのエコシステムに深く依存しているプロジェクトでは、旧パイプラインに戻す判断も現実的だと思う。公式も「レガシーパスだが利用可能」としている。

実際のアップグレード手順

まとめると、自分がやった手順はこうなった。

# 1. パッケージ更新
npx @astrojs/upgrade

# 2. ビルドを回してコンパイラエラーを確認
npx astro build

# 3. 閉じタグ・属性のエラーを修正

# 4. ホワイトスペースの崩れを目視確認

# 5. remarkプラグインの動作確認(必要なら@astrojs/markdown-remarkを追加)

# 6. astro.configからexperimentalフラグを削除
#    rustCompiler, queuedRendering, advancedRouting, cache → 不要に

src/fetch.tsというファイルがある場合はリネームが必要(Astro 7で予約ファイルになった)。自分は該当しなかったが、APIルートで使っている人は注意。

100ページ弱のサイトでコンパイラエラーの修正に手を取られたのは数箇所だったが、数千ページの大規模ドキュメントサイトではHTMLの修正だけでそれなりの作業量になるはず。アップグレード前にnpx astro buildを一度回して、エラーの量を見てから計画を立てるのが安全。

検証環境: Ubuntu 22.04 / Node.js 22.14 / Astro 7.0.0 / Vite 8.0 / 2026年7月検証

参考リンク

#Astro #Rust #Vite #ビルド最適化 #移行
シェア