VS Code 扩展开发实战：AI 自动生成 Git 提交信息

1. 为什么我要自己折腾一个提交信息生成工具

每次写完代码，打开终端敲下 git commit，然后对着那个空荡荡的提交信息编辑框发呆——这个场景我猜你肯定不陌生。尤其是赶项目的时候，一天要提交十几次，每次都要想“这次到底改了啥”“用什么词描述才准确”“要不要写 scope”“type 选 feat 还是 fix”，脑子已经在下一个功能上了，还得回头翻 diff 确认自己改了什么。更别提团队协作的时候，有人写“update”，有人写“修改bug”，有人写“111”，回头查 git log 跟看天书一样。

VSCode Commit AI 这个项目，解决的就是这个具体到不能再具体的问题：在 VS Code 里点一下，自动读取当前暂存区的改动，生成一条符合 Conventional Commits 规范的提交信息，你确认或者微调一下就能直接提交。它不是一个泛泛的“AI 写代码”工具，而是把 AI 能力精准地卡在“写提交信息”这一个动作上，把原本需要 30 秒到 2 分钟的脑力劳动压缩到 3 秒。

这个项目适合谁？如果你是个人开发者，它能帮你保持提交历史的整洁，以后回头看自己的项目不至于一脸懵；如果你是团队里的 Tech Lead，它可以统一整个团队的提交规范，code review 的时候一眼就能看出每个 commit 的性质；如果你刚开始学 Git，它还能顺带教你 Conventional Commits 的写法。不管你是哪种，核心诉求都是一样的：别让我在提交信息上浪费时间，但提交历史还得像样。

我花了大概两周的业余时间把这个扩展从想法做到能日常使用，中间踩了不少坑，也积累了一些关于 VS Code 扩展开发、Git 操作、AI 接口调用的实战经验。下面我把整个项目的设计思路、核心实现、实操步骤和踩坑记录完整地梳理一遍，你如果想自己做一个类似的工具，或者想直接拿我的方案改改用，都可以直接参考。

2. 整体设计与技术选型：为什么这么搭

2.1 核心需求拆解与功能边界

在动手之前，我先把这个工具的需求拆成了几个层次。最核心的需求是：读取 Git 暂存区的 diff，调用 AI 生成提交信息，展示给用户确认后执行提交。围绕这个核心，衍生出几个必须解决的问题。

第一个问题是触发时机。用户什么时候需要生成提交信息？显然是在 git add 之后、git commit 之前。所以扩展需要感知当前工作区的 Git 状态，知道有没有暂存的改动。如果暂存区是空的，那就不应该触发，或者提示用户先暂存文件。

第二个问题是信息展示方式。生成的信息是直接填入 commit message 输入框，还是弹出一个面板让用户选择？我试过直接填入的方式，但有时候 AI 生成的不够准确，用户需要对比多个选项。所以最终方案是弹出一个 Quick Pick 面板，展示 AI 生成的候选信息，用户选一个或者手动编辑。

第三个问题是AI 接口的选择。这里涉及一个关键决策：用云端 API 还是本地模型？云端 API 的好处是生成质量高、响应快，但需要网络和 API Key；本地模型的好处是隐私安全、不依赖网络，但对机器配置有要求，而且生成质量参差不齐。我的选择是优先支持云端 API，同时预留本地模型的接口，让用户根据自己的情况配置。

第四个问题是规范约束。AI 生成的内容如果不加约束，可能会写出“更新了代码”这种毫无信息量的提交信息。所以我需要在 prompt 里明确要求 AI 遵循 Conventional Commits 规范，并且根据 diff 内容自动判断 type（feat、fix、docs、style、refactor 等）。

2.2 技术栈选择与理由

VS Code 扩展的开发语言选择其实不多，主流就是 TypeScript 和 JavaScript。我选了 TypeScript，原因很简单：类型系统能在编译期帮我发现很多低级错误，尤其是涉及 VS Code API 和 Git 操作的时候，类型提示能省掉大量查文档的时间。

构建工具方面，我用了 esbuild 而不是 webpack。esbuild 的构建速度快得离谱，一个几百行的扩展项目，构建时间基本在 100ms 以内，webpack 可能要好几秒。对于需要频繁调试的扩展开发来说，这个速度差异直接影响开发体验。

Git 操作方面，我没有直接调用 child_process 执行 git 命令，而是用了 VS Code 内置的 Git 扩展 API。VS Code 本身集成了 Git 功能，通过 vscode.extensions.getExtension('vscode.git') 可以拿到 Git 扩展的 API，直接读取仓库状态、暂存区 diff 等信息。这样做的好处是不需要自己处理 Git 的路径问题、权限问题，而且和 VS Code 的 Git 面板状态完全同步。

AI 接口方面，我抽象了一层 CommitMessageProvider 接口，目前实现了两个 Provider：一个是基于 OpenAI 兼容接口的云端 Provider，另一个是基于 Ollama 的本地 Prov