Git: Commit按钮灰色是因为Atom未识别Git工作区，必须同时满足三个条件：项目为文件夹、根目录含.git、git路径及全局user.name/user.email已配置。
Git: Commit 按钮为什么是灰色的
不是插件没装好，是 Atom 根本没识别出当前目录是 Git 工作区。它需要三个硬性条件同时满足：项目是文件夹（非单文件）、根目录下存在 .git 目录、git 可执行路径和全局 user.name/user.email 都已配置——缺一不可。
常见卡点：
- 只打开了
main.js文件，没用 File → Open Folder 打开整个项目目录 -
.git目录不存在：按Ctrl + Shift + P输入Git: Init初始化，但初始化后仍需至少一次git commit（哪怕空提交：git commit --allow-empty -m "init"），状态栏才显示分支名 - 右键菜单没
Git选项：只在侧边栏的文件/文件夹上右键有效，编辑器顶部标签页右键不触发
git-plus 报 “Git is not installed” 但终端能跑 git --version
Atom 启动时没继承完整 PATH，尤其 macOS/Linux 图形界面启动、Windows 上 Git 路径配错时高频发生。
实操步骤：
- 终端执行
which git（macOS/Linux）或where git（Windows），复制完整路径（如/usr/local/bin/git或C:\Program Files\Git\cmd\git.exe） - Atom 中进入 Settings → Packages → git-plus → Settings，粘贴到
Git Path字段（Windows 注意用反斜杠\） - 新版 Git 默认把
git.exe放在cmd\下，不是旧版的bin\；填错就报“not installed”，哪怕终端一切正常 - 改完重启 Atom，再试
Ctrl + Shift + H（Win/Linux）或Cmd + Shift + H（macOS）
Commit 失败报 fatal: empty ident name (for ) not allowed
这不是插件问题，是 Git 底层拒绝提交——因为没设身份信息。git-plus 完全复用系统 Git 配置，不读 Atom 设置里的任何用户名字段。
必须在终端执行：
git config --global user.name "Your Name"git config --global user.email "you@example.com"- 验证是否生效：
git config --global user.name和git config --global user.email应返回非空值 - 如果只给当前仓库设，进项目根目录运行
git config user.name "Name"（去掉--global），但注意 git-plus 仍优先读全局配置
Push 失败但看不出原因
表面是网络或权限错误，实际多是本地配置断链。git-plus 的 Git: Push 走原生命令行通道，不弹登录框，也不处理凭据缓存。
排查要点：
-
git remote add origin <url>没执行过，或 URL 少了.git后缀（如https://github.com/user/repo应为https://github.com/user/repo.git） - SSH key 没配或 HTTPS 凭据没存：先确保终端里
git push能成功，再回 Atom 试 - 分支没设置上游：首次推送要加
-u，比如git push -u origin main；之后才能直接Git: Push - 状态栏有
git+图标但没分支名：说明仓库已初始化，但还没任何 commit，Git: Commit也可能不可用
最常被忽略的是：Atom 的 Git 行为完全依赖项目上下文，它不像终端那样“在哪都能敲 git”。打开错文件夹、路径配错、身份没设——这三个点任何一个出问题，整个流程就停在第一步。
