有几种方案可以实现"记录文件/类作用 + 点击跳转":

1. CodeTour(最符合需求)

微软官方插件,专门做代码导览:

  • 记录每个文件的作用说明
  • 点击直接跳转到对应文件和代码行
  • 支持录制导览路径
  • 配置保存在 .tours/ 目录,可提交到git

使用Ctrl+Shift+P → CodeTour: Record Tour

2. Markdown + 链接(简单实用)

配合 Markdown All in One 插件:


[GameRenderer](src/control/GameRenderer.cpp) - 游戏主渲染器

  • Ctrl+点击 直接跳转文件
  • 支持行号定位:src/main.cpp#L25
  • 配合 Path Intellisense 自动补全路径

3. Doxygen + Doxygen Documentation Generator

  • 在代码头文件写文档注释
  • 生成HTML文档后内部可跳转
  • 有侧边栏文件树
  • 缺点:需要生成步骤,不是实时的

4. Better Comments + Bookmarks

  • Better Comments:高亮 //! //? 等特殊注释
  • Bookmarks:给文件/行添加书签并写备注
  • 缺点:Bookmarks不支持写长说明

推荐组合

Markdown All in One + Path Intellisense + CodeTour

  • 日常维护用Markdown链接
  • 复杂流程用CodeTour录制导览
  • 新人 onboarding 直接播放Tour

Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐