Sublime Text 的 Git 功能依赖 wbond 开发的官方 Git 插件，需通过 Package Control 安装并确认作者为 wbond、描述含“command-line git integration”；安装后必须在含 .git/ 的项目根目录下打开文件夹，且系统 PATH 或插件设置中正确配置 git_command 路径，否则 Git: Status 等命令将无法激活或报错。

Sublime Text 本身不带 Git 功能，所谓“结合 Git”，本质是让编辑器调用你本地已安装的 git 命令行工具；插件只是壳，git 路径配错、项目没在 .git/ 目录下、或装错插件，三者任一出问题，提交和分支操作都会失败。

Git 插件必须装 wbond 的 Git，不是 GitGutter 或 GitSavvy

很多人搜 “Git” 装了 GitGutter，结果右键没 Git 菜单、命令面板输不出 Git: Commit——因为 GitGutter 只画绿/蓝/红线，不做任何 Git 操作。真正提供 Git: Checkout、Git: Push、Git: Branch 等完整命令的，只有作者为 wbond 的官方 Git 插件。

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Package Control: Install Package
• 搜索 Git，只选描述含 command-line git integration、作者明确写 wbond 的那个
• 装完别急着用：必须通过 File → Open Folder… 打开一个含 .git/ 子目录的项目根目录，插件才激活
• 如果右键无 Git → Add File，说明路径未通或项目结构不对，不是插件没装好

git_command 必须手动指定，尤其 macOS 和 Windows

Sublime 不继承 shell 的 PATH，GUI 启动时根本看不到 which git 返回的路径。终端里 git --version 成功 ≠ Sublime 能调用它。

• macOS 用户（Homebrew 安装）：which git 返回 /opt/homebrew/bin/git，就在 Preferences → Package Settings → Git → Settings – User 里填：{"git_command": "/opt/homebrew/bin/git"}
• Windows 用户运行 where git，常见路径是 C:Program FilesGitingit.exe，注意反斜杠要双写：{"git_command": "C:\Program Files\Git\bin\git.exe"}
• 验证是否生效：按 Ctrl+` 打开控制台，输入 import subprocess; subprocess.run(['git', '--version'])，有输出即通
• 改完设置不用重启，但得重新打开项目文件夹才能重载

提交流程不能跳步：add → commit → push 必须显式执行

这个插件不自动暂存、不支持 -a、不默认提交全部改动。你以为 Git: Commit 就像 IDE 那样点一下全提交？实际它只对已暂存（staged）文件生效，漏掉 Git: Add File 或 Git: Add All，提交就空转。

GitHub一键发布助手（专业版）

本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、&quot

下载

• 先看状态：Git: Status 弹出只读面板，灰色 = 未暂存（modified/untracked），绿色 = 已暂存
• 暂存单个文件：光标放在灰色文件名上，Ctrl+Shift+P → Git: Add File；或右键该文件 → Git → Add File
• 暂存全部修改：Git: Add All（不是 Add，少个 All 就只加当前文件）
• 提交时弹出临时 buffer，保存即触发 git commit -m；想加 --no-verify，得在设置里配 "git_commit_args": ["--no-verify"]
• Git: Push 前务必确认远程分支已关联，否则报错 fatal: The current branch ... has no upstream branch

分支切换和创建必须从命令面板触发，右键不支持

侧边栏右键菜单里没有 Checkout Branch 或 Create Branch ——这些操作只暴露在命令面板中，且对路径敏感。

• 切换分支：Ctrl+Shift+P → 输入 Git: Checkout，回车后会列出所有本地分支，上下键选择
• 创建并切换新分支：Git: Checkout → 输入新分支名（如 feature/login），回车即创建并检出
• 推新分支到远程：Git: Push → 选 Push new branch，再选刚建的分支名；若直接选 Push current branch，可能报错
• 分支名含斜杠（如 feat/api/v2）完全支持，但中文分支名在 Windows 下可能出编码问题，建议避免

最常被忽略的一点：所有 Git 操作都绑定当前打开的文件夹路径，不支持多根工作区统一操作；如果你从子目录打开项目，.git/ 在上级，插件压根不会加载——必须确保 File → Open Folder… 选的是真正的仓库根目录。