Comment Anchors 插件支持在 VSCode 中通过注释标记(如 TODO、FIXME)快速跳转:需安装插件、启用默认关键字、按语法插入注释、用命令面板列表跳转,并可自定义正则关键字。
如果您在使用 vscode 编写代码时希望快速跳转到特定注释位置,comment anchors 插件可通过在注释中嵌入特殊标记实现高效导航。以下是配置与使用该插件的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Comment Anchors 插件
该插件需通过 VSCode 扩展市场获取并启用,确保其被正确加载后才能识别锚点语法。
1、打开 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Comment Anchors。
3、在搜索结果中找到作者为 Exodius Studios 的插件,点击“安装”按钮。
4、安装完成后点击“重新加载”使插件生效。
二、启用默认锚点关键字
插件预置一组关键词用于识别可跳转的注释,需确认这些关键字未被禁用,否则注释不会被解析为锚点。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 comment anchors keywords。
3、确认 commentAnchors.keywords 设置项中包含 TODO、FIXME、NOTE、HACK、XXX 等默认值。
4、若列表为空或被修改,点击右侧铅笔图标,选择“在 settings.json 中编辑”,手动添加标准关键字数组。
三、在代码中插入可识别锚点注释
插件仅对符合语法规范的注释行触发锚点索引,需严格遵循语言对应的注释格式及关键字前置规则。
1、在 JavaScript 文件中,于任意位置输入 // TODO: 实现用户登录校验逻辑。
2、在 Python 文件中,输入 # FIXME: 数据库连接超时未处理。
3、在 CSS 文件中,输入 /* NOTE: 此样式仅适配移动端 */。
4、保存文件,插件将自动扫描并建立导航索引。
四、使用命令面板快速跳转锚点
插件注册了专用命令,可通过快捷方式唤出所有匹配锚点列表,并支持模糊搜索与即时跳转。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入 Comment Anchors: List Anchors 并回车。
3、在弹出的下拉列表中,使用方向键浏览所有已识别锚点。
4、按回车键直接跳转至对应注释所在行。
五、自定义锚点关键字与正则匹配模式
当默认关键词无法覆盖项目内部约定时,可通过修改正则表达式扩展识别范围,支持大小写敏感控制与分组捕获。
1、打开设置界面,搜索 commentAnchors.customKeywords。
2、点击“在 settings.json 中编辑”,添加如下配置:
"commentAnchors.customKeywords": ["\\bREVIEW:\\b", "\\bIDEA:\\b"]。
3、重启 VSCode 或执行 Developer: Reload Window 命令刷新插件上下文。
4、在代码中使用 // REVIEW: 需要二次确认参数有效性 即可被识别为新锚点。










