You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

同命名空间下Doxygen cref无需完整命名空间却无法生效问题

Doxygen v1.10.0同命名空间下C#类跨引用链接失效问题

我在使用Doxygen v1.10.0为C#代码生成文档时遇到了跨引用链接问题:只有使用完整命名空间限定目标类时,链接才能正常生效。对于同命名空间下的普通非泛型类,这种完整限定写法既冗余又降低了文档可读性。

我未找到针对该问题的相关资料,仅看到过关于泛型类cref的问题以及不同命名空间间链接的相关issue。

文档源码示例

GenerationSource.cs

namespace Runevision.LayerGen {
    /// <summary>
    /// Unity component that creates a <see cref="TopLayerDependency"/>. <br/>
    /// Unity component that creates a \ref TopLayerDependency. <br/>
    /// Unity component that creates a <see cref="Runevision.LayerGen.TopLayerDependency"/>. <br/>
    /// Unity component that creates a \ref Runevision.LayerGen.TopLayerDependency.
    /// </summary>
    public class GenerationSource : MonoBehaviour { }
}

TopLayerDependency.cs

namespace Runevision.LayerGen {
    /// <summary>
    /// All generation starts with one or more top level dependencies at the root.
    /// </summary>
    public class TopLayerDependency { }
}

输出情况

生成的文档侧边栏显示两个类处于同一命名空间,但只有使用完整命名空间限定的<see cref="Runevision.LayerGen.TopLayerDependency"/>和\ref Runevision.LayerGen.TopLayerDependency能生成有效链接,其余未加完整命名空间的写法均无法正常跳转。我尝试过切换Doxygen Awesome主题,但问题依然存在。

自定义Doxygen配置

以下是我修改过的Doxygen配置项(其余为默认设置):

PROJECT_NAME           = LayerProcGen
PROJECT_NUMBER         = v0.1.0
PROJECT_BRIEF          = "Layer-based infinite procedural generation"
OUTPUT_DIRECTORY       = Doxygen
INLINE_INHERITED_MEMB  = YES
EXTRACT_STATIC         = YES
HIDE_SCOPE_NAMES       = YES
HIDE_COMPOUND_REFERENCE= YES
SORT_BRIEF_DOCS        = YES
SHOW_NAMESPACES        = NO
FILE_PATTERNS          = *.cs \
                         *.markdown \
                         *.md
RECURSIVE              = YES
EXCLUDE                = Unity/SaveState/FileBasedPlayerPrefs \
                         doxygen-awesome-css
EXCLUDE_PATTERNS       = */UnitTests/*
USE_MDFILE_AS_MAINPAGE = README.md
HTML_EXTRA_STYLESHEET  = doxygen-awesome-css/doxygen-awesome.css \
                         doxygen-awesome-css/doxygen-awesome-sidebar-only.css
HTML_COLORSTYLE        = LIGHT
GENERATE_TREEVIEW      = YES
GENERATE_LATEX         = NO
CLASS_GRAPH            = TEXT

请问我遗漏了什么配置或设置?


内容的提问来源于stack exchange,提问作者runevision

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.27 04:31:27