Tower需与系统Git配置、SSH认证及权限模型对齐，否则会出现push失败、分支不刷新、冲突视图空白等问题；其行为受git config --global user.name/email严格约束，SSH密钥需手动配置且不共享终端agent环境，交互式rebase要求工作目录干净，子模块和LFS文件需额外操作才能正常显示与使用。
Tower 不是“装上就能用”的傻瓜工具，它需要和系统级 Git 配置、SSH 认证、仓库权限模型对齐，否则你会在 push 失败、分支不刷新、冲突视图空白等地方反复卡住。
为什么 git config --global 会影响 Tower 的行为
Tower 启动时会读取全局和仓库级的 .gitconfig，但不会自动继承你终端里设置的别名或编辑器配置。更关键的是：它严格依赖 user.name 和 user.email 是否已设置 —— 如果没设，某些操作（比如提交后自动推送）会静默失败，界面也不报错。
- 必须执行：
git config --global user.name "Your Name"和git config --global user.email "you@domain.com"，邮箱要和 GitHub/GitLab 账户一致，否则贡献图不显示 - Tower 不识别
core.editor别名（如code --wait），但它会在冲突解决时调用系统默认编辑器；若想用 VS Code，请在 macOS 系统设置 → 通用 → 默认网页浏览器旁手动指定默认文本编辑器 - 如果你用
git config --global core.ignorecase false来规避大小写问题，Tower 会同步生效；但注意：已克隆仓库需运行git config core.ignorecase false单独设置，全局配置不向下兼容
SSH 密钥未被 Tower 识别的三个典型现象
即使你在终端能 git pull 成功，Tower 仍可能提示 “Authentication failed” 或 “Permission denied (publickey)”，因为它不共享终端的 SSH agent 环境变量。
Git Hub Projects V2
下载
使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段（如状态、迭代、优先级等）时使用此技能。
- 现象一：添加远程仓库时 URL 显示为
https://...而非git@github.com:...—— 这说明 Tower 没读到你的 SSH 配置，需手动改 Remote URL（右键仓库 → Settings → Remotes → Edit） - 现象二：点击 Push 按钮后进度条卡住 2 秒，然后消失，无任何提示 —— 检查 macOS 控制台（Console.app），筛选 “Tower” 进程日志，大概率出现
ssh_askpass: exec(/usr/X11R6/bin/ssh-askpass): No such file or directory，这是 SSH agent 未正确加载 - 现象三：Tower 右下角状态栏显示 “Offline” 或远程分支不更新 —— 手动执行
ssh -T git@github.com确认终端可用后，在 Tower 中选择 Repository → Refresh Remote Branches 强制拉取，不是自动同步
交互式 rebase 在 Tower 中失效的常见原因
Tower 的交互式 rebase 界面很直观，但一旦出错，它不会像命令行那样给出 error: cannot rebase: You have unstaged changes 这类明确提示，而是直接禁用按钮或灰掉操作项。
- 前提条件必须满足：工作目录干净（
git status显示 “nothing to commit”），且暂存区为空；Tower 不检查 .git/index 锁，所以如果刚用命令行执行过git add但没提交，它可能误判状态 - 不要在 rebase 过程中切换分支或关闭 Tower —— 它不会保存中间状态，强行退出会导致
.git/rebase-merge目录残留，后续任何 Git 操作（包括命令行）都会报错，必须手动删掉该目录 - 如果你在 rebase 中修改了提交信息，Tower 默认使用系统默认字体渲染，若含 emoji 或中文，可能在历史视图中显示为方块；这不是数据损坏，只是渲染问题，不影响推送
子模块和 Git LFS 文件在 Tower 中的显示异常处理
子模块会出现在文件列表里，但双击打不开；Git LFS 跟踪的大文件（如 PSD、MP4）只显示占位符 SHA，不显示真实内容 —— 这不是 bug，是设计使然，但容易让人误以为“功能坏了”。
- 子模块：右键文件 → “Open Submodule in Tower” 才能进入独立仓库视图；若提示 “No repository found”，说明子模块路径未初始化，需先在终端运行
git submodule update --init --recursive - Git LFS：确保已全局安装 LFS（
git lfs install），且 Tower 启动前终端已执行过git lfs pull；Tower 不自动触发git lfs checkout，所以首次打开时大文件仍为指针，需手动右键 → “Download LFS Files” - 性能提示：含 500+ 子模块或 LFS 文件超 1GB 的仓库，Tower 启动会明显变慢（实测平均延迟 8–12 秒），建议在 Tower Preferences → Advanced 中关闭 “Automatically refresh status on focus” 减少后台轮询
真正难的不是点几下鼠标，而是理解 Tower 哪些动作是“透传给 Git 二进制执行”，哪些是“仅 UI 渲染”。比如分支合并成功后，它不会自动 git push —— 这个边界，文档从不写明，但每次协作出问题，都卡在这里。
