Unityの.metaファイル解説資料

2025年3月10日

本資料では、Unityプロジェクト内で重要な役割を果たす「.meta」ファイルについて、以下の内容を解説します。

1. はじめに

Unityでは、各アセットに対して自動的に「.meta」ファイル（拡張子は必ず小文字）が生成されます。このファイルはYAML形式で記述され、アセットの一意識別やインポート設定、参照関係の維持に重要な役割を果たしています。

各アセットには固有のGUID（グローバル一意識別子）が割り当てられます。これにより、ファイル名やフォルダ構成が変更されても、他のアセットとの参照関係が正しく維持されます。

サンプル:

guid: a1b2c3d4e5f67890abcdef1234567890

解説:
このGUIDは、アセットがシーンやプレハブなど他のリソースから参照される際に利用され、変更があってもリンクが保持される仕組みを実現します。

.metaファイルには、各アセットのインポート時の設定情報も記録されます。たとえば、テクスチャなら圧縮設定や解像度、モデルならスケールやマテリアル情報、オーディオならサンプルレートなどが含まれます。

サンプル（テクスチャの場合）:

TextureImporter:
  fileIDToRecycleName: {}
  serializedVersion: 2
  mipmaps:
    mipMapMode: 0
    enableMipMap: 1

解説:
この設定情報により、Unityはプロジェクトを再読み込みしたり別環境で開いた際にも、同じインポート設定を適用できるため、意図しない挙動を防止します。

.metaファイルはGitやSVNなどのバージョン管理システムに含めることで、各開発者間で同一のGUIDやインポート設定が共有されます。
解説:
複数人で作業する際、同じ.metaファイルを共有することで、アセットの参照切れや設定の不一致を防ぎ、プロジェクト全体の整合性が保たれます。

.metaファイルはYAML形式で記述され、一般的に以下の情報が含まれます。

サンプル:

fileFormatVersion: 2
guid: a1b2c3d4e5f67890abcdef1234567890
timeCreated: 1625227200

解説:
これらの情報により、Unityは各アセットの状態や識別情報を管理し、プロジェクト全体のデータ整合性を維持します。

拡張子は小文字で統一:
Unityは「.meta」という拡張子（小文字）でファイルを認識します。拡張子やファイル名を大文字に変更すると、Unityが正しく認識できなくなるため注意が必要です。
削除・改変のリスク:
.metaファイルを誤って削除または編集すると、GUIDが失われ、シーンやプレハブの参照が切れてしまう可能性があります。
→ 結果として、アセットのリンクが壊れ、プロジェクトが正しく動作しなくなる恐れがあります。
自動生成の仕組み:
Unityは、.metaファイルが存在しない場合に自動生成しますが、その際に新しいGUIDが発行されるため、元のファイルは必ず保持してください。
バージョン管理の徹底:
.metaファイルはプロジェクトの重要な一部です。必ずバージョン管理システムに含め、変更履歴を管理するようにしましょう。