Visual Studio中VB.NET项目生成XML文档选项勾选后消失，求替代方案

勾选选项后消失的原因 #

• 项目类型不支持：部分特殊VB.NET项目（比如.NET Framework网站项目、特定轻量模板项目）本身不支持通过UI界面开启XML文档生成，勾选后设置无法被保存，导致选项自动消失。
• VS缓存损坏：Visual Studio的项目设置缓存出问题，没法持久化这个勾选操作。可以试试删除项目根目录下的.vs隐藏文件夹，重启VS再重新操作。
• 文件锁定：如果.vbproj文件是只读状态，或者被其他程序占用，修改后的设置写不进去，也会导致选项消失。重启VS或者解除文件锁定后再试。

手动修改vbproj文件生成XML文档 #

如果UI设置行不通，直接改项目文件是靠谱的办法，步骤如下：

1. 关掉Visual Studio里的目标项目。
2. 在文件管理器里找到项目的.vbproj文件，用记事本或VS Code打开。
3. 找到对应你当前配置（比如Debug/AnyCPU）的<PropertyGroup>节点，添加以下配置代码：

<DocumentationFile>$(OutputPath)$(AssemblyName).xml</DocumentationFile>
<NoWarn>$(NoWarn);1591</NoWarn>

• DocumentationFile用来指定XML文件的输出路径和名称，默认会和编译后的程序集放在同目录、同名。
• NoWarn里的1591是关闭“缺少XML注释”的警告，要是你想保留这个警告，删掉这部分就行。

4. 保存.vbproj文件，重新打开项目编译，就能在输出目录看到生成的XML文档了。

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