C#中能否为现有partial类及方法追加多平台专属文档注释？

C#原生不支持跨partial类的不同文件，为同一个已定义的类、方法追加XML文档注释。编译器处理XML注释时，仅会保留第一个扫描到的对应成员的注释块，其余文件中针对同一已有成员的注释会被直接丢弃，不会合并。

• 方案1：核心文件内嵌条件编译注释
  在公共的核心代码文件中，通过平台专属的编译符号，把不同平台的补充注释写到同一个注释块里，编译时会自动保留对应平台的内容，示例代码如下：

/// <summary>Class <c>Point</c> models a point in a two-dimensional plane.
#if BLAZOR
/// <br/>Blazor 平台：本类采用CSS标准坐标体系，原点位于容器左上角。
#elif WINFORMS
/// <br/>WinForms 平台：本类采用GDI+标准坐标体系，原点位于控件左上角。
#endif
/// </summary>
public partial class Point 
{
    /// <summary>method <c>draw</c> renders the point.
#if BLAZOR
    /// <br/>Blazor 平台：渲染时自动生成CSS定位属性，支持响应式适配。
#endif
    /// </summary>
    void draw() { ... }
}

该方案的优势是编译后对应平台的智能提示可以直接展示完整注释，不需要跳转查看额外内容。

• 方案2：平台专属文件新增说明入口
  如果不想在核心文件中耦合平台相关代码，可以在核心注释里预留指向平台说明的引用标签，再在各平台的partial文件中实现对应的说明入口：

// 核心Point.cs中
/// <summary>Class <c>Point</c> models a point in a two-dimensional plane.
/// <para>平台专属特性详见 <see cref="PlatformSpecification"/>。</para>
/// </summary>
public partial class Point 
{
    void draw() { ... }
}

// Blazor专属Point.Blazor.cs中
public partial class Point
{
    /// <summary>
    /// Blazor平台专属说明：
    /// 1. 坐标体系采用CSS标准，原点为容器左上角
    /// 2. draw方法会生成对应的style.left/top属性完成渲染
    /// </summary>
    public static string PlatformSpecification => "Blazor CSS Coordinate Adapter";
}

• 方案3：重载方法继承+补充注释
  如果是平台专属的重载方法，可以用标签继承核心方法的基础注释，再补充平台专属说明：

// Blazor专属Point.Blazor.cs中
public partial class Point
{
    /// <inheritdoc cref="draw()"/>
    /// <summary>
    /// 补充：Blazor平台专属重载，支持传入自定义渲染上下文调整渲染效果。
    /// </summary>
    void draw(CssRenderContext context) { ... }
}

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