sourcetree只是git的gui封装，依赖系统git；需手动配置git路径并验证git --version一致；push失败多因凭据未配置或过期，须用token替代密码；双击文件默认用系统程序打开，应改为外部编辑器；staged files等同git add，暂存即生效。
SourceTree 本身不“管理仓库”，它只是 Git 的图形界面封装；所有操作最终都调用本地安装的 Git 命令行工具执行。如果你没装 Git，SourceTree 启动时会报错 Git not found —— 这是第一个必须确认的前提。
怎么让 SourceTree 正确识别并使用系统 Git
SourceTree 默认尝试自动查找 Git，但 Windows 上常因路径含空格、权限或多版本共存而失败；macOS 上则可能找不到 Homebrew 安装的 Git。
- Windows：打开 Tools → Options → Git，勾选 Use System Git，手动指定路径，比如
C:\Program Files\Git\bin\git.exe（注意不是cmd\git.exe） - macOS：在终端运行
which git，复制输出路径（如/opt/homebrew/bin/git），粘贴到 SourceTree 的 Preferences → Git → Path to Git - 验证方式：任意仓库中右键选择 Terminal，输入
git --version，输出应与命令行一致；否则后续所有操作（如推送失败、中文乱码）都可能溯源至此
为什么点击 Push 总是卡住或提示 authentication failed
这不是 SourceTree 的问题，而是 Git 凭据配置缺失或过期。SourceTree 不接管凭据存储，它完全依赖系统级 Git 凭据管理器（Windows Credential Manager / macOS Keychain / Linux libsecret）。
- 首次 Push 前，务必先在终端执行一次
git push，按提示输入账号密码（GitHub 已禁用密码登录，需用 Personal Access Token 替代） - GitHub 用户：生成 Token 时至少勾选
repo权限，并用该 Token 当作密码填入凭据弹窗；Token 要保存好，界面上不会再次显示 - 如果已输错多次导致被锁，删掉系统凭据里对应域名的记录（例如
github.com），再重试一次终端git push触发新弹窗
如何避免双击文件后误操作导致工作区混乱
SourceTree 的文件列表双击行为默认是「用系统默认程序打开」，不是「在编辑器中打开」—— 这对代码文件极危险（比如双击 package.json 可能用记事本打开并保存，破坏换行符或编码）。
- 进 Tools → Options → General（macOS 是 Preferences → General），把 Double-click action 改成 Open in External Editor
- 同时指定外部编辑器路径：推荐 VS Code，填
code --wait（Windows/macOS 均可），确保它已加入 PATH（macOS 需在终端执行code --install-server） - 顺手关掉 Auto-refresh（在同一个选项页），否则频繁刷新可能掩盖你刚暂存的修改状态
最常被忽略的一点：SourceTree 的「Staged files」区域不是魔法区，它和命令行的 git add 完全等价；一旦你在这里点了 Stage，就等于执行了 git add，后续 git status 也会显示相同结果。别把它当临时备份区用 —— 暂存即承诺，撤回要用 git restore --staged，不是拖来拖去就能取消的。
