メインコンテンツにスキップ
すべての記事
2025年3月12日にReportsで公開

Anthropic Sonnet 3.7で差分ビューアが壊れた話

Anthropic Sonnet 3.7で差分ビューアが壊れた話

はじめに

Claude 3.7 Sonnetにアップグレードした際、出力能力の向上は想定どおりで、私たちも歓迎していました。しかし予想していなかったのは、差分ビューアにパフォーマンスのボトルネックが見つかったことです。変更されたファイルの数が増えるにつれて、ブラウザがフリーズするようになったのです。

この記事では、発生した問題、検討した代替案、そして実装した解決策について詳しく解説します。

こちらが私たちの差分ビューアです。

Lovableのコード差分ビューア

要点まとめ

  • CodeMirrorのインスタンスは1つあたり読み込みに20〜50msかかり、読み込み中はブラウザをブロックします。
  • 多数のエディタ(15個以上)を一度に読み込むと、すべてのエディタが順番に読み込まれるため、ブラウザがフリーズします。
  • 解決策:処理を小さなチャンクに分割し(タイムスライシング)、ブラウザの応答性を保ちます。

問題

Claude 3.7 Sonnetそのものが問題だったわけではありません。原因は3.5と比べて出力量が増えたことでした。出力が増えたことで、Lovableは一度により多くのファイルに、より多くの変更を加えられるようになったのです。

私たちはコード差分の表示にCodeMirrorを使用しています。CodeMirrorのインスタンスを数個読み込む程度なら問題ありませんが、15個以上のファイルを一度に表示すると、ブラウザのフリーズが目立つようになります。フリーズ時間はお使いのマシンによって500msから1500msほどになります。

なぜでしょうか?CodeMirrorのインスタンスは1つあたり初期化に20〜50msかかり、その間ブラウザをブロックします。私たちはすべてのインスタンスを一度に読み込んでいたため、1つの長いブロッキングタスクが発生していました。その間、ユーザーはページのどの部分も操作できませんでした。

パフォーマンスをプロファイリングしたところ、高性能なマシンで約20ファイルを表示した場合に、メインスレッド上で約500msの長いタスクが1つ発生していることがわかりました。低速なデバイスやネットワークスロットリング下では、さらに悪化します。

プロファイリング

強制リフローを理解する

上のパフォーマンスプロファイルの画像には、赤いマーカーの付いた紫色のバーが見えます。これは強制リフローを示しており、今回のパフォーマンス問題の一因となっています。

リフローとは?ブラウザがページ上の要素のレイアウトを再計算することです。通常、ブラウザは効率化のためにこれらの計算をまとめて行います。しかし、JavaScriptが次のような処理でこのプロセスに割り込むと、「強制リフロー」が発生します。

  1. DOMに変更を加える(要素の追加や変更など)
  2. その直後にレイアウト情報を要求する(要素のサイズを取得するなど)

このパターンでは、ブラウザがすぐにレイアウトを計算せざるを得なくなり、処理のコストが高くなります。

CodeMirrorの初期化処理はこの強制リフローを引き起こします。これは既知の問題で、GitHubの複数のIssueでも報告されています。こうした不要なリフローによって、各エディタインスタンスの初期化コストが本来よりもさらに高くなり、パフォーマンス問題を一層悪化させていました。

最適なアプローチを探る

このパフォーマンス問題に取り組むにあたり、いくつかの解決策を検討しました。

  1. すべてのファイルをデフォルトで折りたたむ

    • 仕組み:ユーザーがファイルを展開したときにのみCodeMirrorを初期化する
    • 欠点:ユーザーは見たいファイルを1つずつ手動でクリックしなければならない
  2. 最初の3ファイルを表示し、残りは折りたたむ

    • 仕組み:最初の3ファイルはすぐに読み込み、それ以外はクリックされたときにのみ初期化する
    • 欠点:大半の変更を見るには、依然として手動で展開する必要がある
  3. ビューポートに入ったファイルを展開する

    • 仕組み:Intersection Observerを使い、ユーザーがスクロールしてファイルに到達したときに読み込む
    • 欠点:実装が複雑になるうえ、CodeMirrorインスタンスの初期化自体に時間がかかるため、高速スクロール時にちらつきが発生する可能性がある

どのアプローチにも良い点はありましたが、私たちの譲れない要件は次のとおりでした。

  • 手動操作を最小限に抑え、シームレスなユーザー体験を維持すること
  • ブラウザをフリーズさせる長いタスクをなくすこと

これらの選択肢を検討した結果、私たちは別の解決策にたどり着きました。それがタイムスライシングです。この手法では、CodeMirrorのインスタンスを小さなバッチに分けて初期化し、バッチの合間にブラウザへ制御を戻します。

その結果は?1つの長いブロッキングタスクが複数の短いタスクに分割され、すべてのコンテンツを読み込みながらも、インターフェースの応答性を保てるようになりました。

解決策:Reactによるタイムスライシング

すべてのファイルを一度に読み込むのではなく、次のようにしました。

  1. 最初はごく少数のファイル(一度に2つずつ)だけをすぐにレンダリングする
  2. 残りのファイルにはローディング用のプレースホルダーを表示する
  3. プレースホルダーを少しずつ実際のコンテンツに置き換える
  4. 各バッチの間に短い待ち時間(50ms)を入れ、ブラウザが応答できる状態を保つ

この方法により、1つの長いブロッキングタスクが、合間を挟んだ複数の短いタスクに分割されます。その合間にブラウザはユーザー操作を処理でき、応答性を保てます。

このパターンは、Reactで次のように実装できます。

function BatchRenderer({ items }) {
  // Start by rendering just the first 2 items
  const [renderedCount, setRenderedCount] = useState(Math.min(2, items.length));
  const timeoutRef = useRef(null);

  // Clean up timeout when component unmounts
  useEffect(() => {
    return () => {
      if (timeoutRef.current) clearTimeout(timeoutRef.current);
    };
  }, []);

  // Schedule rendering of next batch
  useEffect(() => {
    if (renderedCount < items.length) {
      timeoutRef.current = setTimeout(() => {
        setRenderedCount((prevCount) => Math.min(prevCount + 2, items.length));
      }, 50); // 50ms delay between batches
    }
  }, [renderedCount, items.length]);

  return (
    <div>
      {items.map((item, index) => (
        <div key={item.id}>
          {index < renderedCount ? (
            // Render actual content for batched items
            <ExpensiveComponent data={item} />
          ) : (
            // Show placeholder for items not yet rendered
            <PlaceholderComponent />
          )}
        </div>
      ))}
    </div>
  );
}

この実装なら、数十個のファイルを表示する場合でも、読み込み中ずっとインターフェースの応答性が保たれます。

下の画像のとおり、1つの長いブロッキングタスクではなく、複数の小さなタスクに分かれています。

Sonnet 3.7での修正後のプロファイリング結果

ユーザー体験の向上

タイムスライシングは、技術的なパフォーマンスの問題を解決しただけでなく、見た目の体験もはるかにスムーズにしました。

この変更以前は、裏側で(すべてのインスタンスの)初期化が行われている間、ユーザーにはすべての差分が折りたたまれた状態で表示されていました。そして目に見えるほどの遅延の後、すべての差分が一斉に展開されるため、唐突で違和感のある印象を与えていました。

バッチ処理を取り入れたことで、最初の2つの差分はほぼ即座に表示され、残りは順次読み込まれるようになりました。コンテンツが一度にまとめて現れるのではなく滑らかに流れ込んでくるため、より自然で軽快な感覚が生まれます。

まとめ

タイムスライシングによって、ブラウザがフリーズする問題を解決できました。1つの長いタスクを複数の短いタスクに分割することで、すべてのファイルを読み込みながらもインターフェースの応答性を保てるようになりました。

この方法はCodeMirrorに限らず、負荷の高いあらゆるUI処理に有効です。同様の問題に直面したら、タイムスライシングで長いタスクを分割し、アプリの応答性を保つことを試してみてください。

小さな変更が、パフォーマンスに大きな違いをもたらすことがあります。

アイデアから数秒でアプリへ

AIとチャットしながらアプリをつくれます。

無料で始める