在C#中，启用XML文档生成功能即可导出类注释为XML文件：Visual Studio中勾选“生成”选项卡的“XML文档文件”，或在.csproj中设置GenerateDocumentationFile为true，并使用///规范编写注释。

在C#中，将类注释（即XML文档注释）导出为XML文件，只需启用编译器的XML文档生成功能，无需额外工具或代码。

启用XML文档生成（Visual Studio）

在项目属性中开启“XML文档文件”选项：

• 右键项目 → “属性” → “生成”选项卡
• 勾选“XML文档文件”复选框
• 默认路径为 bin\Debug\YourProject.xml（Debug配置下），也可手动指定路径，如 bin\Debug\MyApiDocs.xml

正确编写文档注释

只有以 /// 开头、符合XML文档规范的注释才会被提取。例如：

/// <summary>
/// 计算两个整数的和。
/// </summary>
/// <param name="a">第一个加数
/// <param name="b">第二个加数
/// <returns>两数之和</returns>
public static int Add(int a, int b)
{
    return a + b;
}

注意：

、、 等标签需闭合，且 name 属性必须与参数名完全一致（区分大小写）。

通过命令行（dotnet CLI）生成

若使用 dotnet build，可添加 /doc 参数指定输出路径：

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

dotnet build /doc:bin\Debug\MyDocs.xml

或在项目文件（.csproj）中显式配置：

<propertygroup><generatedocumentationfile>true</generatedocumentationfile><nowarn>$(NoWarn);1591</nowarn><!-- 忽略缺少XML注释警告 --></propertygroup>

验证与使用

生成后，XML文件会包含所有公开类型、成员的注释节点，IDE（如Visual Studio、Rider）和IntelliSense会自动读取并显示提示。可直接用浏览器打开查看结构，也可配合工具（如DocFX、Sandcastle）生成HTML帮助文档。

不复杂但容易忽略：确保注释是 ///（不是 // 或 /* */），且仅对 public 和 protected 成员生效（默认情况下 private 不包含）。