Visual Studio/C#：如何让示例文件纳入智能感知但不参与编译

针对你遇到的问题，有两种实用方案可以同时满足不编译示例文件和**保留Visual Studio智能特性（自动补全、语法高亮）**的需求：

方案一：使用<AdditionalFiles>配置 #

修改项目文件中的ItemGroup为以下内容：

<ItemGroup>
  <AdditionalFiles Include="Samples\Program-*.cs" />
</ItemGroup>

<AdditionalFiles>会让Visual Studio将这些文件识别为代码文件，提供完整的智能提示和语法高亮，但不会将它们纳入编译流程，从根源避免“多个顶级语句”的编译错误。

方案二：保留<Compile>标记但禁用编译 #

如果你希望示例文件在项目中仍以“代码文件”的身份显示，可以用ExcludeFromBuild属性跳过编译：

<ItemGroup>
  <Compile Include="Samples\Program-*.cs" ExcludeFromBuild="true" />
</ItemGroup>

这种方式下，文件依然属于项目的代码文件集合，VS会正常提供智能特性，而ExcludeFromBuild="true"会告诉编译器忽略这些文件，不会触发编译错误。

补充说明 #

• 方案一适合将示例文件作为“参考文档类代码”管理，不会被代码分析工具默认扫描；
• 方案二更贴近常规代码文件的项目结构，智能特性的支持更稳定，适合需要频繁修改示例的场景。

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