atom github插件需三者对齐：git路径正确（如macos填/usr/bin/git）、github登录用personal access token（非密码）、仓库为https克隆（ssh克隆pr功能失效）；且仅在含.git文件夹的仓库根目录中激活。
Atom 默认自带 github 插件，但“连接成功”不等于“能用”，关键在 Git 环境、认证方式和仓库上下文三者是否对齐。多数失败不是插件没装，而是本地 Git 未配置或认证走 HTTPS 却没配 token。
Git 可执行文件路径必须手动指定
Atom 不会自动猜你的 git 命令在哪。macOS 或 Linux 下可能在 /usr/bin/git，Windows 下常是 C:\Program Files\Git\bin\git.exe。路径错会导致所有 Git 操作按钮灰掉、右键无响应、GitHub 面板显示 “No repository found”。
- 打开 Atom → Settings → Core →
Git Path输入框填绝对路径 - 终端运行
which git（macOS/Linux）或where git（Windows）确认真实位置 - 改完重启 Atom，否则设置不生效
登录 GitHub 必须用 Personal Access Token，不能输密码
2021 年 8 月起 GitHub 已禁用密码登录 API，Atom 的 github 插件调用的是 GitHub REST API，所以用账号密码点登录会静默失败，界面卡在 loading 或直接退回登录框。
- 去 GitHub → Settings → Developer settings → Personal access tokens → Generate new token
- 至少勾选
repo和workflow（如果用 Actions） - 复制生成的 token，在 Atom 的
GitHub面板里选 “Login with token” 粘贴 - 别存 token 到剪贴板太久，也别写进配置文件——Atom 不加密存储它
SSH 克隆的仓库无法触发 GitHub 插件的 PR 功能
用 git clone git@github.com:user/repo.git 方式克隆的项目，Atom 能做提交/推送/分支管理，但 Create Pull Request 按钮不可用，点击无反应。因为插件依赖仓库 URL 中的 HTTPS 格式（含用户名/组织名）来拼接 GitHub API 路径。
- 检查当前仓库远程地址：
git remote get-url origin - 如果是 SSH 地址，临时切为 HTTPS：
git remote set-url origin https://github.com/user/repo.git - PR 创建完可再切回 SSH（不影响后续 push/pull）
- 注意：HTTPS 地址下推送需 token 认证，不能靠系统钥匙串自动填密码
“Push” 按钮灰色？先确认分支是否已关联上游
新创建的本地分支默认没有 upstream，即使你点了 Push，Atom 也不会报错，只是按钮一直灰。这不是 bug，是 Git 本身的行为约束。
- 命令行验证：
git rev-parse --abbrev-ref --symbolic-full-name @{u}，若报错说明没关联 - 在 Atom 中右键分支名 → “Push Branch”，它会自动帮你设 upstream 并推送到 origin
- 或者手动运行：
git push -u origin your-branch-name - 之后
Push按钮才变可用，且右下角状态栏会显示 “origin/your-branch-name”
最常被忽略的一点：Atom 的 github 插件只在「已识别为 Git 仓库的文件夹」中激活。直接打开单个文件、或打开父级非仓库目录，右侧根本不会出现 GitHub 面板——它不靠你手动启用，而靠 .git 文件夹是否存在、是否可读。别花时间调插件开关，先 cd 进项目根目录看一眼 ls -a | grep .git。
