Assembly Definition (asmdef) 設定ミスによる無限コンパイルの回避策

Assembly Definition (asmdef) 設定ミスによる無限コンパイルの回避策は、実機テストやレンダリングパイプライン拡張において頻発する重度なテクニカルバグです。C#スクリプトを1文字書き換えるたびに、Unityエディタが何十秒も「Compiling...」とフリーズする遅延の解決策の解説。

不具合の具体的な症状

スクリプトファイル（.cs）を1行書き換えて保存してUnityに戻るたびに、右下の「くるくるマーク（コンパイルインジケータ）」が10秒〜30秒以上回り続け、エディタ全体が完全にフリーズして一切の操作を受け付けなくなる。

現実世界での例え：辞書の1文字（1箇所のコード）を修正するたびに、辞書全体の数千ページを最初からすべて本として印刷・製本し直す超無駄な巨大印刷工場

プロジェクトのコードすべてが1本の超巨大な巻物（Assembly-CSharp）になっているため、末尾の文字を直すだけでも、巻物全体を最初から最後まで検閲して書き直す作業が毎回発生しています。フォルダごとに「独立した薄い冊子（asmdefによる個別アセンブリ）」に分冊しておくことで、修正された冊子だけを印刷し直せば済むようにし、他の綺麗な冊子はそのまま使い回して待ち時間を一瞬（数ミリ秒）に短縮します。

想定される原因と詳細な仕組み

プロジェクト内のすべてのスクリプトが、標準の単一の巨大なDLL（Assembly-CSharp.dll）にまとめられており、わずか1文字の修正であっても、関係のない数千個の全スクリプトファイルをCPUが毎回ゼロから再コンパイルしてリンクし直しているためです。

解決アプローチと最適化手順

フォルダ構成を機能やシステム（例：コア、UI、外部ライブラリなど）ごとに綺麗に小分けし、それぞれのフォルダに「Assembly Definition (asmdef)」アセットを配置して別々の独立したDLLファイルにコンパイル単位を完全に分離します。