【CodeBuddy 基本功】插件精选:筛选与长期管理

本文是【CodeBuddy 基本功】系列文章第5部分：
①键盘 ②键位 ③配置 ④内置能力：先于插件 ⑤插件与集成：精选而非堆砌 ⑥视觉与环境：超越好看 ⑦实战技巧与组合 ⑧AI 与编辑器 ⑨工具与人

往期内容回顾：

①键盘、②键位：默认快捷键与键位定制

③配置：一份让 VS Code 安静下来的配置清单

④内置能力：编辑器自带工具链

05 插件与集成：精选而非堆砌

插件市场里有 5 万+扩展。装到 50 个的人不少，日常真正在用的往往不超过 10 个。剩下的 40 个是启动变慢、功能重叠、维护停滞的尾部。新手期广装是正常的探索，但探索期过后，插件的问题更多是"不装什么"而不是"装什么"。

这一章的结构：先给筛选标准（5.1），再给通过筛选的清单（5.2），然后讲两个值得深入的集成方向：终端和 Git（5.3），最后用 Profile 管理长期演化（5.4）。

5.1 插件边界三问

每个想装的插件过三道筛：

一、内置能做吗？ 04 章列的 Task、正则搜索、Snippets、Timeline、Inlay Hints、Sticky Scroll、Multi-root，五六年前有一半还不存在，现在都进了核心。装插件前先 Cmd+Shift+P 搜相关关键字，超过一半的"必装插件"其实已被内置覆盖。

二、一周用过吗？ 装的时候觉得有用，一周后打开 Extensions 面板数一下，有多少插件上周实际触发过。没触发的是启动开销的净负担。

三、拖慢启动了吗？Cmd+Shift+P → Developer: Startup Performance 打开启动性能报告。超过 100ms 的值得警觉，超过 500ms 的除非核心刚需否则应当移除。

三问过完，插件列表通常能瘦下去一半。

5.2 精选插件清单

筛选标准：过了 5.1 的三问、不依赖特定技术栈、社区活跃度持续、装了之后几天内就会用上。技术栈专有的（某框架的语言服务、某数据库客户端、某语言的 linter）不列，按项目需求自取。

诊断与反馈

插件	一句话
Error Lens	把错误/警告直接渲染在行尾，不需要悬停、不需要打开 Problems 面板。装了就回不去
Pretty TypeScript Errors	TypeScript 的错误信息出了名的难读（嵌套泛型、联合类型展开成一坨）。这个插件把它重新格式化成彩色、可折叠的结构。配合 Error Lens 效果更好

Error Lens

https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens

Pretty TypeScript Errors

https://marketplace.visualstudio.com/items?itemName=yoavbls.pretty-ts-errors

诊断类就这两个，但它们是整个清单里回报率最高的，装完当天就会感受到区别。

文本操作

插件	一句话
Text Power Tools	大小写转换、排序、去重、JSON 格式化、Base64 编解码，几十种文本操作集成在 Command Palette 里
Transformer	管道思路，选中文本 → 过滤/对齐/去重/排序/反转 → 输出到新文档或替换。处理日志、CSV、多行批量操作比逐行正则快
Regex Previewer	写正则时在侧边实时显示匹配结果。不用再开浏览器跑 regex101

Text Power Tools

https://marketplace.visualstudio.com/items?itemName=qcz.text-power-tools

Transformer

https://marketplace.visualstudio.com/items?itemName=dakara.transformer

Regex Previewer

https://marketplace.visualstudio.com/items?itemName=chrmarti.regex

导航与项目管理

插件	一句话
Project Manager	给项目打标签、分组、收藏。`Cmd+R` 按时间排序，Project Manager 按命名空间组织
Todo Tree	把代码里散落的 TODO/FIXME/XXX 聚合成侧边栏树，按文件或按标记类型分组
Bookmarks	在代码中打书签，跨文件跳转。处理大型代码库时比"记住行号"可靠得多
Peacock	给不同工作区窗口设置不同颜色。同时开三四个项目时一眼区分"我现在在哪"

Project Manager

https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager

Todo Tree

https://marketplace.visualstudio.com/items?itemName=Gruntfuggly.todo-tree

Bookmarks

https://marketplace.visualstudio.com/items?itemName=alefragnani.Bookmarks

Peacock

https://marketplace.visualstudio.com/items?itemName=johnpapa.vscode-peacock

Git 与版本控制

插件	一句话
GitLens	行内 blame、文件历史、交互式 commit 图、分支比较。VS Code 内置 Git 只覆盖基础操作，GitLens 补齐了"理解历史"这一层
Git Graph	可视化分支拓扑，合并、rebase、cherry-pick 的结果在图上一目了然。注：已多年未更新，新版编辑器偶有兼容问题，介意维护状态可换活跃替代

GitLens

https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens

Git Graph

https://marketplace.visualstudio.com/items?itemName=mhutchie.git-graph

文档与写作

插件	一句话
Markdown All in One	快捷键加粗/斜体、自动目录、表格格式化、列表续写。写 Markdown 的基础设施
Markdown Preview Mermaid Support	让内置 Markdown 预览直接渲染 Mermaid 代码块（流程图、时序图、类图），和 GitHub/GitLab 的渲染一致。注：VS Code 1.121（2026.5）起已把 Mermaid 预览并入内核，新版可不必再装
Code Spell Checker	变量命名、注释、Markdown 中的英文拼写错误。对中文母语开发者尤其有用，英文写多了总会拼错

Markdown All in One

https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one

Markdown Preview Mermaid Support

https://marketplace.visualstudio.com/items?itemName=bierner.markdown-mermaid

Code Spell Checker

https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker

API 与调试

插件	一句话
REST Client	在 `.http` 文件里写请求、按 `Cmd+Opt+R` 发送、看响应。文件可以提交到仓库，团队共享 API 调试用例，比 Postman 集合更轻
Thunder Client	GUI 式 REST 客户端，如果你习惯 Postman 的界面但不想离开编辑器。和 REST Client 选一个即可

REST Client

https://marketplace.visualstudio.com/items?itemName=humao.rest-client

Thunder Client

https://marketplace.visualstudio.com/items?itemName=rangav.vscode-thunder-client

可视化与预览

插件	一句话
CodeSnap	生成干净的代码截图，带语法高亮、可选行号、透明背景。写文档、发社交媒体、做演示时用
Image Preview	在引用图片路径的行旁边直接显示缩略图预览

CodeSnap

https://marketplace.visualstudio.com/items?itemName=adpyke.codesnap

Image Preview

https://marketplace.visualstudio.com/items?itemName=kisstkondoros.vscode-gutter-preview

AI 时代的新刚需

这些插件本身不提供 AI 能力，但服务于 AI 生成内容的验证、调试和管理。工具链不止覆盖"生成"那一步。

插件	一句话
Live Preview	编辑器内嵌浏览器 + 实时刷新。Vibe coding 产出的最常见格式是单文件 HTML，这是验证 AI 产出的最短路径
LLM Tokenizer	实时显示选中文本的 token 数（GPT/Claude/Gemini/DeepSeek 等 60+ 模型）。写 system prompt、估算上下文窗口是否溢出时用
Dotenv (Official)	`.env` 语法高亮，外加自动打码（auto-cloaking，编辑器里把值遮成圆点）、自动补全、悬停查看值。AI 生成的项目模板几乎都带 `.env`（API key、模型端点），屏幕共享前的自动打码很实用。但要清楚打码只是显示层遮挡——值仍在文件里，别把它当真正的密钥保护，该不提交的照样别提交（纯语法高亮可选更轻的 `mikestead.dotenv`）

Live Preview

https://marketplace.visualstudio.com/items?itemName=ms-vscode.live-server

LLM Tokenizer

https://marketplace.visualstudio.com/items?itemName=MatteoTeodori.llm-tokenizer

Dotenv (Official)

https://marketplace.visualstudio.com/items?itemName=dotenv.dotenv-vscode

关于 Live Preview 多说一句。Anthropic 工程师 Thariq Shihipar 在 2026 年 5 月发文论证 HTML 正在取代 Markdown 成为 AI 输出的默认格式（https://x.com/trq212/status/2052809885763747935）。报告、原型、可视化、交互式文档都是 .html。传统 Markdown 没有交互、没有动态布局、图表靠外部渲染；而 AI 随手生成的带 CSS + JS 的单文件 HTML 可以包含可折叠目录、可交互图表、响应式布局、暗色模式、搜索框。Live Preview 因此从"前端辅助工具"变成了"所有人验证 AI 产出的基础设施"。

基础设施

这两个不是"插件"意义上的能力扩充，它们改变的是编辑器的运行位置，把 VS Code 从"本地编辑器"变成"可以接管任何环境的控制面"。

插件	一句话
Remote - SSH	在远程机器上运行 VS Code Server，UI 在本地但所有操作在远程执行。笔记本性能不够、代码在服务器上时用
Dev Containers	把开发环境放进 Docker 容器。团队环境一致性、隔离实验性依赖时用

CodeBuddy 的远程开发能力不受后文所述的许可证限制影响，它用的是自研的 open-remote-ssh 和 genie-dev-container，不依赖微软闭源扩展。

清单到这里。再往下加，就不是"精选"了。

故意不列的几类

• 被内置覆盖的：Bracket Pair Colorizer（1.60 起原生支持，原扩展已归档）、IndentRainbow（内置 Indent Guide 只画竖线，不如色块直观，见 §6.2）、Auto Close Tag / Auto Rename Tag（内置 editor.linkedEditing 覆盖 HTML/JSX）。遇到老教程推荐这些时，先打开内置功能确认
• 依赖团队约定的：Better Comments 按 // TODO:// !// ? 分色高亮，团队不在用这套约定时就是装饰
• 依赖技术栈的：Prettier、ESLint、Tailwind CSS IntelliSense、Import Cost，它们确实好用，但只在对应技术栈下才有意义，不属于"通用精选"
• 主观偏好：图标主题、颜色主题，个人审美，没有通用推荐价值

5.3 工具集成

插件扩展的是"编辑器能做什么"，集成扩展的是"编辑器和外部工具怎么协作"。终端和 Git 是两个最高频的集成方向，内置能力打底、插件按需增强、AI 在上面再加一层。

Shell Integration

VS Code 内置终端自 1.70 版（2022）起默认启用 Shell Integration，Zsh / Bash / PowerShell(pwsh) 当时即覆盖；Windows PowerShell（传统 5.x）在 1.74 补上，Fish 自 1.80（2023.6）起自动注入。它不只是把 shell 嵌进来，而是和 shell 做了双向通信。开启后获得三类能力：

• 命令块跳转：每条执行过的命令自成一个块，Cmd+Up / Cmd+Down 在块之间跳转。输出长的命令不需要滚动条翻。
• 命令状态可视化：每条命令左侧绿勾 / 红叉，一眼扫完哪条出了问题。
• Quick Fixes：命令失败时出现灯泡图标，点进去有一键修复选项（如 git push --set-upstream origin xxx）。

Shell Integration 大多数 shell 下自动启用。没启用时手动加一行：

# macOS / Linux · Zsh：写入 ~/.zshrc[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"# Bash：写入 ~/.bashrc，把上面的 zsh 换成 bash# Fish：在 ~/.config/fish/config.fish 里执行 code --locate-shell-integration-path fish# PowerShell：在 $PROFILE 里 . "$(code --locate-shell-integration-path pwsh)"

终端集成把"命令行"从一个嵌入的窗口升级为编辑器状态的一部分。命令、输出、错误都变成可导航的对象。

终端 × AI

CodeBuddy 在终端上叠加了一层 AI 对话。光标在终端时按 Cmd+I 唤起，直接问"怎么写这条命令"或"这个报错什么意思"：

快捷键	作用
`Cmd+I` （终端聚焦时）	唤起终端 AI Chat
`Cmd+Enter`	直接运行 AI 建议的命令
`Opt+Enter`	插入命令但不运行（安全阀：先看一眼再决定）
`Cmd+R` （终端 chat 聚焦时）	重跑上一次 AI 请求
`Esc`	关闭终端 chat

终端里报错时还有更短的路径：选中报错文本后右键，菜单里直接有"添加到 CodeBuddy 对话"、"解释此命令"、"修复此命令"三个入口，零记忆成本。AI 看到完整的终端环境信息，回答质量比手动复制粘贴到 Chat 面板高。

Git

VS Code 内置 Git 面板覆盖日常 80%：查看改动、stage/unstage、commit、push/pull、分支切换、合并冲突解决。内置之外值得补两个方向：

• 行级 blame 和历史浏览 → GitLens。编辑器内每行旁边显示"这行谁什么时候改的、commit 信息是什么"。读老代码时快速定位决策上下文。
• 分支拓扑可视化 → Git Graph。合并、rebase、cherry-pick 的结果在图上一目了然。

不要装太多 Git 插件。市场上十几个名字相近的 Git 扩展，真正常用就是上面两个，其他按 5.1 三问决定。

CodeBuddy 在 Git 层额外提供 AI 生成 commit message：在 Source Control 面板写 commit 时触发，基于当前 staged 改动自动生成提交信息。它省掉的不是打字时间，是"看着一堆 diff 组织一句话"的认知负担。生成后仍需人工审阅微调，但起点比空白高得多。

5.4 Profile

Profile 是一整套"设置 + 插件 + 键位 + UI 状态"的命名快照。

典型划分：

Profile	包含的插件	配置差异
Default	通用生产力插件	日常编码
Writing	Markdown 相关、拼写检查、Zen Mode 预设	关闭代码 linter，开启 `editor.wordWrap`
Demo	只保留核心插件，放大字体	演示时视觉干净
Debug / Bare	几乎不装插件	排查"插件是否导致问题"时的对照组

切换：Cmd+Shift+P → Profiles: Switch Profile，瞬间换一套。

创建：Cmd+Shift+P → Profiles: Create Profile → 选"从当前 Profile 复制" → 命名 → 切换过去卸掉不需要的插件、调整 settings。跨机器复用走 Profiles: Export Profile... 生成 .code-profile 文件。

Profile 的价值在于场景隔离：写文档时不被 TypeScript 报错打断，演示时不被 GitLens 行末注释分散注意力，排障时有纯净对照环境。

5.5 许可证围墙

CodeBuddy、Cursor、Windsurf、Trae 等编辑器都基于 VS Code 内核，插件格式相同（.vsix），理论上互通。但"理论上互通"和"实际能用"之间有一道许可证围墙。

微软的 Visual Studio Marketplace 使用条款规定（https://cdn.vsassets.io/v/M253_20250303.9/_content/Microsoft-Visual-Studio-Marketplace-Terms-of-Use.pdf）：市场中的扩展仅供 Visual Studio、VS Code、GitHub Codespaces 等微软自家产品使用。2025 年 4 月起，微软在部分第一方扩展中主动执行这一限制，检测宿主产品 ID，非 VS Code 直接拒绝加载。目前已确认受限的：

• C/C++（ms-vscode.cpptools）：语言服务、调试器、IntelliSense
• C#（ms-dotnettools.csharp）：语言服务
• Pylance（ms-python.vscode-pylance）：Python 类型检查、自动补全

第三方 fork 的应对是转向 Open VSX Registry(https://open-vsx.org/)（Eclipse 基金会维护的开源替代市场）。代价是上述闭源扩展没有官方版本，只能用社区替代（clangd(https://clangd.llvm.org/) 替代 C/C++ 扩展，basedpyright(https://github.com/DetachHead/basedpyright)替代 Pylance）。大多数场景下替代品功能覆盖已经足够。

对你的实际影响：如果你用 CodeBuddy 写 C++/C#/Python，留意语言服务是否正常工作。智能提示突然消失时大概率是许可证问题，搜对应语言的开源替代方案即可。

5.6 关于 AI 插件

这一章故意没列任何 AI 插件（Copilot、Continue、Cody 等）。原因有二：这一层变化最快，每月都有能力更迭和定价调整，列出来半年就过时；AI 插件的评估标准也不同，不是"装了就长期用"，是"用几天就要重新判断还要不要"。

整体替换形态的 AI IDE（CodeBuddy、Cursor、Trae、Qoder、Windsurf）不是插件，是把 AI 做进编辑器内核。IDE 选型 08 章专门讨论，这一章先留白。

插件的筛选比选择更重要。5.1 的三问过完、5.2 的清单兜底、5.4 的 Profile 兜远期，三件事做到位，插件列表可以在 15 个以内维持多年不动。

插件解决的是"编辑器能不能做某件事"，下一章解决的是"做的时候看不看得清"。视觉层直接影响所有能力的发挥效率。

作者：涂洁航

关注我们，

让每一次阅读都沉淀为技术能力↓↓↓