GitHub Desktop 是 Git 的图形界面封装，需理解 git add/commit/push 等命令原理；登录卡住多因代理或防火墙拦截 OAuth 跳转；“no changes”常因状态未刷新、文件被忽略或换行符问题；Push 失败主因是远程地址错误、凭证过期或 SSO 授权不足。
GitHub Desktop 不是 Git 的替代品，它只是 Git 的图形界面封装；你依然得理解 git add、git commit、git push 这些动作在背后干了什么，否则点错按钮就丢代码。
安装后第一次启动就卡在“Sign in to GitHub”怎么办
不是网络问题，大概率是系统代理或企业防火墙拦截了 OAuth 跳转。GitHub Desktop 启动时会自动打开浏览器完成授权，但某些环境（比如 Windows 上装了腾讯电脑管家、Mac 上开了 Surge/Clash 规则）会劫持 https://github.com/login/oauth/authorize 这类回调地址。
- 临时关闭本地代理工具或安全软件再试
- 如果必须走代理，改用「Add repository from URL」手动添加远程库，跳过登录步骤（适合只读或已有 token 的场景）
- 确认系统时间准确——OAuth 令牌校验对时间偏移敏感，误差超过 5 分钟就会失败
为什么点了 Commit 后 GitHub Desktop 显示“no changes to commit”
常见于刚克隆完仓库、文件明明改了却看不到差异。本质是 Git 状态没刷新，或者文件被忽略。
- 检查左下角是否显示
Changes标签页里为空；如果空，点右上角Refresh按钮（不是刷新网页那种，是客户端里的同步图标） - 看文件是否在
.gitignore里——比如你改了node_modules/下的某个文件，它永远不会出现在变更列表中 - Windows 用户注意换行符：若仓库设置为
core.autocrlf=true，而你用非 Git 工具编辑了文件，Git 可能认为“内容没变”，实际只是 CRLF/LF 被自动转换了
Push 失败提示 “Authentication failed” 或 “Remote rejected”
不是密码错了（GitHub 已禁用密码登录），而是凭证没配对或权限不足。
- 确保登录的是你有写权限的账号——比如你 fork 了别人的仓库，但本地 remote 指向原作者的地址，push 必然被拒；应先用
git remote set-url origin https://github.com/你的用户名/仓库名.git改掉 - 检查凭证管理器（Windows Credential Manager / macOS Keychain）里存的是否还是旧 token 或已过期的 Personal Access Token（PAT）；GitHub Desktop 有时不会自动更新它
- 如果你用的是 SSO 组织账号，需要在 GitHub 上手动为该 PAT 授权对应组织，否则即使 token 本身有效，也会被
Remote rejected
最麻烦的不是操作步骤多，而是所有错误都藏在“点一下就能搞定”的表象下面——比如你以为只是提交，其实涉及暂存区、当前分支、上游追踪关系、远程权限、甚至 SSH key 和 HTTPS token 的混用。不看一眼终端里的 git status 和 git remote -v，光靠图形界面容易误判。
