必须满足三个硬性条件：项目为文件夹且含.git目录、git可执行路径配置正确、已设置全局user.name和user.email，缺一不可。
git-plus 命令灰显或提示 “No git repository found” 怎么办
不是插件没装好，而是 Atom 根本没识别到 Git 工作区。它只在「文件夹级」生效，且严格依赖 .git 目录存在。
- 必须用 File → Open Folder 打开整个项目目录，不能只双击打开单个
.js或.py文件 - 检查项目根目录下是否存在隐藏的
.git文件夹：终端执行ls -a（macOS/Linux）或dir /ah（Windows） - 若没有，先在该目录运行
git init，再回 Atom 按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Init触发一次初始化 - 重启 Atom —— 即使已打开文件夹，首次加载也可能缓存失败，重启最稳
git-plus 提示 “Git not found” 或 “git is not installed”
Atom 不继承图形界面启动时的完整 PATH，尤其 macOS/Linux 从 Dock 启动、Windows 从快捷方式启动时，git 命令常不可见。
- 终端里先确认真实路径：
which git（macOS/Linux）或where git（Windows），结果类似/usr/local/bin/git或C:\Program Files\Git\cmd\git.exe - 进 Settings → Packages → git-plus → Settings，把上面查到的完整路径粘贴进
Git Path字段（Windows 注意用反斜杠\） - 别填
git-bash.exe或git.cmd：它们不是 Git 二进制，会导致所有命令静默失败 - 新版 Git（2.10+）默认把
git.exe放在cmd\目录下，不是旧版的bin\，填错就报错
Commit 按钮灰色、Push 报 fatal: empty ident name
git-plus 完全复用系统 Git 配置，它不提供独立用户名输入框。错误来自 Git 底层拒绝无身份提交。
- 必须在终端执行：
git config --global user.name "Your Name"和git config --global user.email "you@example.com" - 验证是否生效：
git config --global user.name应输出非空字符串；否则 commit 必然失败 - 如果只希望当前仓库生效，去掉
--global，但需确保你在项目根目录下执行git config - GitHub Personal Access Token（PAT）不是必须项：只有用
GitHub: Login功能才需要，普通git push走 SSH key 或 HTTPS 凭据
Stage（Add）没反应、状态栏不更新
git-plus 的 stage 操作只对「已保存」且「未被 .gitignore 排除」的变更生效，且右键菜单仅出现在侧边栏文件/文件夹节点上。
- 改完代码务必先按
Ctrl+S（Win/Linux）或Cmd+S（macOS）保存，否则git add对未保存内容无效 - 右键操作必须点侧边栏里列出的文件或文件夹条目，不是顶部标签页的文件名
- 检查
.gitignore是否意外排除了当前文件：终端运行git status --ignored看是否标为 ignored - 首次初始化后还没任何 commit，状态栏可能不显示分支名，此时可先跑
git commit --allow-empty -m "init"建立初始提交
