如何在C# HTML格式文档中添加代码内方法引用？

当然可以实现啦！在C#的XML注释体系里，我们有专门的标签来处理这种内部代码成员的引用，不管是在Visual Studio这类IDE里查看注释时的即时跳转，还是生成HTML文档后的可点击链接，都能完美实现你的需求。

核心方法：使用<see>标签 #

你只需要在XML注释里用<see cref="目标成员"/>语法，就能指向代码里的其他方法、类、属性等成员。IDE会自动识别目标成员，生成文档时也会自动转为可跳转的链接。

针对你的代码示例的具体实现 #

结合你给出的Test.Calculate和Check.Checking方法，修改Checking的XML注释如下：

/// <summary>
/// 执行检查逻辑，过程中会调用<see cref="Test.Calculate(int)"/>方法计算辅助值
/// </summary>
/// <param name="y">检查逻辑所需的参数y</param>
/// <param name="x">将传递给<see cref="Test.Calculate(int)"/>的计算参数</param>
/// <param name="z">检查逻辑所需的参数z</param>
void Checking(int y, int x, int z)
{
    //code
    bool aux = Test.Calculate(x);
    //code
}

一些注意事项 #

• 如果目标方法存在重载，一定要在cref里明确指定参数类型（比如上面的(int)），这样才能精准指向你要引用的那个重载版本。
• 如果Test类和Check类不在同一个命名空间下，需要在cref里加上完整的命名空间，比如：<see cref="YourNamespace.Test.Calculate(int)"/>，也可以用全局::前缀来避免命名冲突：<see cref="全局::YourNamespace.Test.Calculate(int)"/>。
• 当你用工具（比如DocFX、Sandcastle）生成HTML文档时，这些<see>标签会自动被转换成可点击的链接，点击后就能直接跳转到Calculate方法的文档页面。

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