git-plus插件无反应，先确认系统git命令是否可用；若git --version报错，则需修复path配置；再检查atom项目根目录是否等于git仓库根目录，否则功能禁用。
git-plus 插件装完没反应？先确认 Git 命令行是否可用
插件本身不自带 Git，它只是调用你系统里已安装的 git 命令。如果终端里执行 git --version 报错或无输出，git-plus 就会静默失效——界面按钮灰掉、右键菜单不出现、命令面板搜不到 Git: … 条目。
常见原因和操作建议：
- Windows 用户：检查安装 Git 时是否勾选了 “Add Git to the system PATH”（推荐选“Use Git from Windows Command Prompt”）；若已安装但未配置，需手动把 Git 的 bin 目录（如
C:\Program Files\Git\bin）加进系统环境变量PATH - macOS 用户：若用 Homebrew 安装过 Git，确保
/usr/local/bin在PATH中；若用 Xcode 自带 Git，可能版本太老（git --version显示 2.30 以下），建议用brew install git替换 - Linux 用户：确认
which git有返回，且不是/usr/bin/git这类阉割版（某些发行版预装的 git-svn-only 版本不支持git config --global等基础命令）
右键菜单/命令面板里找不到 Git 操作？检查项目是否在 Git 仓库根目录下
git-plus 只在当前 Atom 窗口的项目根目录下检测 .git 文件夹。如果只是打开了某个子文件夹（比如 src/utils），即使上层有 .git，插件也认为“不在仓库中”，所有 Git 功能禁用。
验证和修复方法：
Cnb Cool Git
下载
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
- 在 Atom 中打开终端（
Ctrl+Shift+T或Cmd+Shift+T），运行git rev-parse --show-toplevel，看输出路径是否与 Atom 左下角显示的“Project Root”一致 - 如果不一致：关闭当前窗口 → 用 Atom 菜单栏
File → Add Project Folder…，选择包含.git的最外层目录（不是子文件夹） - Atom 不会自动向上查找 .git；它只认你“显式添加”的那个文件夹为 project root
点击 Git: Commit 后弹窗空白或提交失败？注意 staging 区状态和 commit 模板
git-plus 的提交流程依赖暂存区（staging）。它不会自动帮你 git add，而是直接读取当前暂存状态生成提交列表。如果你没提前 git add 或用插件的 Git: Stage File，弹窗里就什么文件都看不到。
典型问题和应对：
- 想一键提交所有修改？先用
Git: Stage All（或右键文件选Stage），再点Git: Commit - 提交后报错 “Aborting commit due to empty commit message”？说明你没填内容就点了 Commit。插件默认不设模板，必须手动输入；可提前配好全局 commit template：
git config --global commit.template ~/.gitmessage，然后创建该文件写默认提示 - 中文路径/文件名提交乱码？确保 Git 配置了
core.quotepath false和i18n.commitencoding utf-8，否则git-plus解析git status输出时会截断
和其他 minimap 插件冲突导致 git-diff 色块不显示？优先关掉 minimap-highlight-selected
minimap-git-diff 渲染依赖 minimap-plus 的底层 DOM 结构，而 minimap-highlight-selected 会劫持同一类 CSS 选择器（如 .minimap-selection），覆盖颜色样式，结果就是色块变淡、偏移、甚至完全不可见。
实操建议：
- 禁用
minimap-highlight-selected（不是卸载，只需停用）；这是冲突率最高的插件 - 保留
minimap-cursorline是安全的，但它只高亮当前行缩略图位置，不影响 diff 渲染 - 调高
minimap-plus设置里的Contrast（建议 ≥ 0.85）和Opacity（建议 ≥ 0.95），尤其在暗色主题下，浅绿/浅红容易被背景吞掉 - 别指望它精确定位到某一行——它靠的是
git diff --cached输出的 hunk 行号估算，混合中文或 emoji 时偏差 1～2 行属正常现象
git-plus 的行为高度依赖你本地 Git 的配置状态、项目目录结构、以及与其他插件的样式协作。最容易被忽略的其实是“项目根目录是否等于 Git 仓库根目录”这一条——很多用户反复重装插件，却没意识到 Atom 根本没加载对文件夹。
