Git Workbench

Git Workbench 是面向 Visual Studio Code 的 Git 工作台，将改动审查、提交管理、版本比较、历史追溯和托管评审整合到同一界面。

支持通过 VSIX 安装。

功能参考 · 更新日志 · 开发与发布计划 · 第三方声明

主要功能

• 改动与提交：按暂存状态查看文件，逐行或逐块审查，使用 Changelist 组织改动并独立提交。
• 版本比较：比较分支、标签、提交、暂存区和工作区，支持目录树、状态筛选、批量应用与三方合并。
• 提交历史：浏览拓扑提交图，组合搜索作者、路径、说明和内容变化，执行常用历史操作。
• 编辑器追溯：查看当前行作者、Blame、CodeLens、文件与行范围历史，复制固定版本的远程链接。
• 工作管理：管理分支、远程、标签、Worktree、Stash、Shelf、本地历史和任务上下文。
• 托管评审：连接 GitHub、GitLab、Bitbucket Cloud 或 Azure DevOps Services，查看与处理 PR / MR。

环境要求

在 Remote SSH、WSL 或 Dev Containers 中，应将扩展安装到仓库所在的远程环境，并确保该环境中的 Git 可用。当前不支持 vscode.dev、虚拟工作区和受限模式。

安装与启动

1. 获取 idea-git-panel-0.1.1.vsix。
2. 在扩展面板的 … 菜单中选择 从 VSIX 安装 / Install from VSIX…。
3. 打开包含 Git 仓库的目录，并信任工作区。
4. 点击活动栏的 Git Workbench 图标，或执行 Git Workbench: Open。

侧边栏优先复用编辑器已识别的 Git 仓库和 Git 路径，同时检测工作区目录；已初始化但尚无提交的仓库也会直接列出。确认没有仓库后，才显示 初始化仓库和克隆仓库引导；未打开文件夹时，可先选择 打开文件夹。检测失败会单独显示错误，并提供重新检测、Git 设置和日志入口。

也可通过命令行安装或替换现有版本：

code --install-extension idea-git-panel-0.1.1.vsix --force

安装完成后，执行 开发人员: 重新加载窗口 / Developer: Reload Window，加载当前版本的界面和菜单。

快速开始

审查并提交改动

1. 打开 本地更改，检查已暂存、未暂存、未跟踪和冲突文件。
2. 点击文件查看差异，通过文件操作暂存改动；可用 全选 和 暂存选中 批量处理当前筛选结果，或点击 暂存全部 暂存整个仓库（含筛选外文件）。需要部分暂存时使用 行 或 块。
3. 填写提交说明，或点击 生成提交说明，检查生成内容后提交；也可使用 Ctrl+Enter，macOS 使用 ⌘+Enter。

提交说明在本地根据实际文件差异生成，采用 type(scope): 描述 的 Conventional Commits 格式，并附文件操作、增删行数及可识别的符号名。生成范围默认优先使用暂存区；没有暂存改动时使用已保存的工作区变更，也可手动选择范围和 feat、fix、docs 等类型。无法确定业务意图时默认使用 chore，请在提交前调整类型和描述。已有草稿会保留，并提供候选说明供选择。生成全部工作区说明后，仍需暂存希望提交的改动。

普通提交使用真实暂存区；文件勾选用于批量操作。提交选中文件和仅提交当前列表分别提供独立的提交范围，详见功能参考。

提交面板的底部主按钮随仓库状态切换：暂存区有改动时显示 提交，提交后有待拉取或待推送的提交时显示 同步更改，按钮内显示对应方向的提交数量；工作区干净且无差异时显示 已同步。未设置上游时可 发布分支，未配置远程时可 添加远程。顶部的获取更新按钮用于刷新远程跟踪状态，上游失效或数量不可用时不会误报已同步。

同步会先快进拉取上游，再推送当前分支；分支分叉时会停止，可在提交区的 更多菜单中通过 拉取更新选择 Merge 或 Rebase 后重试。菜单中的 推送提交在原生 Git 终端中执行，支持交互认证；最近说明、提交检查、高级提交以及保存与恢复操作也归入该菜单。

比较两个版本

1. 点击 快捷比较，或进入 比较 页面。
2. 选择左侧基准和右侧目标。两端均支持分支、标签、提交、暂存区或工作区。
3. 点击 开始比较，在文件列表或目录树中浏览结果。
4. 单击文件查看内嵌预览；双击、按 Enter 或点击 在 VS Code 中打开，查看原生差异。

快捷范围包括全部未提交、已暂存、未暂存、最近一次提交、上游和主干。分支比较可选择仅查看目标分支自共同祖先以来的改动。

拖动文件区与预览之间的分隔线可调整大小；双击恢复默认。点击 放大比较区可扩展结果区域，按 Esc 返回。布局偏好、筛选和文件选择会保留。

应用或合并比较结果

勾选文件或目录后，选择左侧版本、右侧版本或改动合并方向，再执行批量操作。应用版本将完整版本写入当前工作区；合并改动通过三方合并保留当前文件中的独立修改。

写入前会校验文件状态并保存原内容。操作目标为当前工作区，比较分支和暂存区保持不变。完成后应审查结果，再暂存和提交。冲突文件可通过 VS Code 合并编辑器处理；批量合并遇到冲突时停止，需单独处理对应文件。

浏览历史与执行操作

在 提交历史 中选择提交查看详情。搜索可组合说明、作者、文件、分支、日期和内容条件，例如：

author:"张 三" file:src/login.ts branch:main after:2026-01-01

顶部 全部 Git 操作菜单支持搜索和键盘选择，也可执行命令 Git Workbench: Git Actions…。文件、提交和分支的更多菜单提供相应上下文操作。

界面与键盘操作

文件区域支持 列表 / 目录树切换，各模块分别保存显示偏好。下拉选择器支持搜索、方向键、Enter 确认和 Esc 关闭。

改动标记优先使用 VS Code 主题的 Git 配色；后备配色如下。类型同时通过字母和悬停说明表达。

配置

点击工作台右上角的 设置，即可分别开关 当前行 Git 信息和代码上方 Git 信息（CodeLens）。修改后立即生效并保存到当前工作区；未打开工作区时保存到用户设置。通过 更多设置 或仓库侧边栏标题中的齿轮可打开 VS Code 的插件设置。

快捷设置中的 界面语言支持 跟随 VS Code（自动）、简体中文和 English，默认跟随 VS Code 显示语言。工作台各页签、比较面板、托管评审、右键菜单、命令面板、编辑器 Git 提示、仓库引导页、操作弹窗、通知、错误提示和自动生成的提交说明均支持中英文。切换后界面即时更新，保留当前页签、选择与提交草稿。也可在 VS Code 设置中搜索 gitWorkbench.language。

VS Code 设置页的配置说明和侧栏视图标题跟随 VS Code 自身的显示语言。仓库文件、分支名称、已有提交说明及 Git / 托管服务返回的原始内容保留原文。

行末 Git 信息随光标移动，旧行信息立即隐藏；代码上方的 CodeLens 仅在光标位于文件或函数起始行时显示。鼠标悬浮到任意已跟踪的代码行，可查看原生 Git 详情卡片：作者、相对时间与提交日期、说明、历史操作及此行附近的改动预览。未保存的修改也参与预览；长改动会截取显示。

在 VS Code 设置中搜索 gitWorkbench，或在 settings.json 中配置以下选项。

自定义检查通过可执行文件和参数数组配置，单项超时为 120 秒。首次使用或修改命令后需确认。

{
  "gitWorkbench.commitChecks.commands": [
    {
      "name": "TypeScript 检查",
      "command": "node",
      "args": ["node_modules/typescript/bin/tsc", "--noEmit"]
    }
  ]
}

数据与凭据

Git Workbench 不自动收集遥测。托管服务令牌保存在 VS Code SecretStorage 中，与 Git credential helper 或 SSH agent 分别管理。连接托管服务或执行远程 Git 操作时，会访问相应服务。

文件历史和 Shelf 保存在仓库外的本地扩展存储中；任务改动备份使用 Git 管理目录、专用引用及 Stash。存储范围、清理方式和恢复限制见功能参考。本地历史依赖扩展运行及可观察事件，不能替代独立备份。

开发与验证

开发环境要求 Node.js 22.12 或更高版本及 npm。

npm ci
npm run check
npm run format:check
npm test
npx playwright install chromium
npm run test:ui
npm run package

按 F5 启动 Extension Development Host。npm run package 会重新构建并生成 git-workbench-<版本号>.vsix，版本号取自 package.json。 也可运行 npm run package:vsix，这是相同打包流程的快捷入口。

Git 集成测试使用临时仓库，浏览器测试使用演示数据。真实 VS Code、托管账号、远程环境和跨平台验证要求见开发与发布计划。

许可证

本项目采用 MIT License。随包分发的第三方组件及许可证见第三方声明。