如何修复VS Code中Unity项目的USG0001（仅一个.AdditionalFile.txt文件）错误

错误原因 #

USG0001是Unity内置Roslyn分析器的规则，核心限制是项目中只能存在一个.AdditionalFile.txt文件，这类文件用于Unity代码分析的自定义配置。

优先修复方案 #

• 遍历Unity项目目录，找出所有后缀为.AdditionalFile.txt的文件，仅保留一个符合需求的，删除其余多余文件。
• 若需要保留多份配置内容，可将所有配置合并到同一个.AdditionalFile.txt文件中，避免触发重复文件检测规则。

禁用错误提示的有效方法 #

你之前的.editorconfig配置因目标范围匹配问题未生效，可尝试以下几种方式：

方法1：修正.editorconfig配置 #

将配置的目标范围调整为全局或C#文件，而非.csproj：

[*]
dotnet_diagnostic.USG0001.severity = none

或仅针对C#相关文件：

[*.cs]
dotnet_diagnostic.USG0001.severity = none

方法2：修改项目csproj文件 #

找到项目中的Assembly-CSharp.csproj（或对应其他程序集的csproj文件），添加以下配置：

<PropertyGroup>
  <NoWarn>$(NoWarn),USG0001</NoWarn>
</PropertyGroup>

注意：Unity可能会自动重新生成csproj文件，修改前建议备份，或通过Unity项目设置间接调整（若支持）。

方法3：通过VS Code设置直接禁用 #

打开VS Code设置（快捷键Ctrl+,），搜索dotnet diagnostic severity，找到USG0001规则，将其严重性设为None。

内容的提问来源于stack exchange，提问作者Nice Zombies