Sublime Text如何配置Git环境_Sublime Text集成Git版本控制教程【整合】-sublime-PHP中文网

sublime text 的 git 功能需同时满足三条件：安装 wbond 官方 git 插件、通过 open folder 打开含 .git 的项目根目录、系统 git 命令在 path 中或手动配置 git_command 路径；缺一即导致命令灰显、右键无菜单或“git not recognized”错误。

sublime text如何配置git环境_sublime text集成git版本控制教程【整合】

Sublime Text 本身不带 Git，装了插件也不等于能用——90% 的“Git 不生效”都卡在 git 命令找不到，或当前文件不在有效仓库路径下。

为什么 Git: Status 命令不出现、右键没菜单？

不是插件没装好，是 Sublime 没识别到 Git 仓库上下文。插件只在「当前窗口根路径下存在 .git/ 目录」时才激活：

必须用 File → Open Folder… 打开整个项目目录（不能双击单个 .js 或 .py 文件）
侧边栏顶部显示的路径中必须包含 .git（比如 /Users/me/project/.git）
按 Ctrl+Shift+P 输入 Git: Status，如果命令灰显或根本不列出，说明还没进仓库
单个文件、子目录（如 /src/utils/）下打开，插件直接“隐身”

“git is not recognized” 错误怎么修？

插件不自带 git，它只调系统 PATH 里的可执行文件。终端能跑 git --version ≠ Sublime 能继承这个环境：

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

macOS：GUI 启动（双击图标）时 PATH 默认只有 /usr/bin；Homebrew 安装的 git 在 /opt/homebrew/bin/git 就被忽略。解决方式二选一：
– 终端运行 open -a "Sublime Text"
– 或手动配置：Preferences → Package Settings → Git → Settings – User，填入：{"git_command": "/opt/homebrew/bin/git"}
Windows：重装 Git for Windows，务必勾选 Add Git to the system PATH（推荐选 “Use Git from Windows Command Prompt”）；已装错就先运行 where git 看路径，再填进上面的 git_command 配置
Linux：桌面启动常丢 $PATH，建议终端执行 subl .；或改 sublime-text.desktop 的 Exec= 行为：Exec=env PATH=$PATH subl %F

装对插件：认准 wbond 维护的 Git，不是 GitGutter 或 SublimeGit

GitGutter 只显示行级变更标记（绿/蓝/红线），SublimeGit 已停更且不兼容 Sublime Text 4；真正支持 Git: Commit、Git: Push 等完整命令的是官方插件 Git，作者是 wbond：

按 Ctrl+Shift+P → 输入 Package Control: Install Package → 搜索 Git → 只选描述含 command-line git integration、作者为 wbond 的那个
别选 GitGutter（纯视觉）、SideBarGit（功能残缺）、SublimeGit（2015 年停更）
装完后打开一个含 .git/ 的项目，右键应出现 Git → Add 子菜单；没有？说明插件未激活或路径不通

常用操作限制与容易踩的坑

这个插件是轻量 CLI 封装，不是 IDE，很多“理所当然”的事它不做：

Git: Commit（Ctrl+Shift+K）不支持 -a 或 --amend；想跳过 git add 直接提交所有修改？得先手动执行 Git: Add，或切终端
Git: Diff（Ctrl+Shift+D）对比的是工作区 vs 暂存区，不是 vs HEAD；要看历史版本 diff 得用 Git: Browse Repository
首次 git: push 报 No upstream branch 是正常现象，插件不会自动补 --set-upstream，需手动处理或换用 GitSavvy
左侧行号旁的 + ~ − 标记不是这个插件提供的，那是 GitGutter 的事；装了 Git 插件但没装 GitGutter，就不会有颜色标记