代码检查:文件名应与程序集名称匹配
在 Unity 中,程序集定义(.asmdef )文件用于定义自定义托管程序集。 每个 .asmdef 文件都包含一个 "name" 属性,用于指定程序集名称。
最佳做法(并且通常也是明确和正确程序集解析的要求)是 .asmdef 文件名应与其定义的程序集名称一致。 如果不一致,可能会导致某些环境下程序集解析出现混淆或问题。
修正方法
请确保磁盘上的 .asmdef 文件名称与其 "name" 字段中指定的字符串一致。
// File: OldName.asmdef
{
"name": "NewName",
"references": [],
"includePlatforms": [],
"excludePlatforms": []
}
// File: NewName.asmdef
{
"name": "NewName",
"references": [],
"includePlatforms": [],
"excludePlatforms": []
}
可以使用 重命名文件以匹配程序集名称 快速修复来自动重命名磁盘上的文件。
2026年 5月 8日