SourceTree安装与使用指南
安装与配置
-
系统要求
- Windows: 7/10/11(需.NET 4.7.1+)
- macOS: 10.15(Catalina)+
- 硬件: 2GB内存(推荐4GB)
-
安装步骤
- 官网下载: SourceTree官网
- 跳过账户绑定: 首次启动选“Skip”,后续通过“工具→选项→账户”添加。
- 关联Git:
- 优先使用嵌入式Git(自动安装);
- 已安装Git则选“使用系统Git”。
-
SSH配置
ssh-keygen -t ed25519 -C "your_email@example.com" # 推荐ed25519算法- 公钥路径:
~/.ssh/id_ed25519.pub,复制到GitHub/GitLab等平台。
- 公钥路径:
仓库管理
-
克隆远程仓库
- 操作路径:点击
克隆/新建→ 输入 Git 仓库 URL(支持 SSH/HTTPS) → 选择本地路径 → 确认克隆。 - 常用命令:
git clone git@github.com:your-username/repo.git
- 操作路径:点击
-
添加本地仓库
- 操作路径:
文件 → 添加现有本地仓库→ 选择包含.git文件夹的目录。
- 操作路径:
分支操作
-
创建分支
- 操作路径:点击顶部
分支按钮 → 输入分支名称 → 选择基准提交(如main)。 - 规范建议:
- 功能分支:
feature/xxx - 修复分支:
bugfix/xxx
- 功能分支:
- 操作路径:点击顶部
-
切换/检出分支
- 操作路径:左侧分支列表 → 双击目标分支。
-
合并分支
- 操作路径:
- 切换到目标分支(如
main)。 - 右键待合并分支(如
feature/login)→合并到当前分支。
- 切换到目标分支(如
- 冲突解决:
- 手动编辑冲突文件 → 标记为已解决 → 提交合并结果。
- 操作路径:
提交与推送
-
暂存与提交
- 操作路径:
- 在
未暂存文件列表勾选文件 → 点击暂存所选。 - 输入提交信息(推荐语义化格式,如
feat: 新增登录功能)→ 点击提交。
- 在
- 操作路径:
-
推送至远程
- 操作路径:点击
推送→ 选择远程仓库(如origin)→ 勾选分支。 - 强制推送(慎用!):
- 启用方式:
工具 → 选项 → Git → 允许强制推送。
- 启用方式:
- 操作路径:点击
高级功能
-
标签管理
- 创建标签:右键提交记录 →
新建标签→ 输入版本号(如v1.0.0)。 - 推送标签:点击
推送→ 勾选包含标签。
- 创建标签:右键提交记录 →
-
Git Flow 工作流
- 初始化:点击
Git Flow→ 设置主分支(main)和开发分支(develop)。 - 创建功能分支:
Git Flow → 开始新功能→ 输入分支名(如feature/payment)。
- 初始化:点击
-
子模块管理
- 添加子模块:右键仓库根目录 →
添加子模块→ 输入子模块仓库 URL。 - 更新子模块:右键子模块 →
更新子模块,或执行命令:git submodule update --init --recursive
- 添加子模块:右键仓库根目录 →
版本控制
-
回滚提交
- 操作路径:右键提交记录 →
回滚提交→ 强制推送覆盖远程。 - 命令等效:
git revert <commit-hash> # 生成反向提交
- 操作路径:右键提交记录 →
-
重置分支
- 操作路径:右键目标提交 →
重置当前分支到此提交→ 选择模式:- 软重置:保留本地更改(仅移动 HEAD)。
- 硬重置:彻底回退(删除后续提交)。
- 操作路径:右键目标提交 →
配置优化
-
SSH 密钥配置
- 生成密钥:
ssh-keygen -t ed25519 -C "your_email@example.com" # 推荐 ed25519 算法 - 添加公钥:复制
~/.ssh/id_ed25519.pub到 Git 平台(GitHub/GitLab)。
- 生成密钥:
-
合并工具配置
- 路径:
工具 → 选项 → 比较/合并→ 选择 Beyond Compare/Meld 等工具。
- 路径:
-
代理设置
- 路径:
工具 → 选项 → 网络→ 输入 HTTP/HTTPS 代理地址。
- 路径:
注意事项
| 场景 | 解决方案 |
|---|---|
| 推送失败(权限不足) | 检查 SSH 密钥是否绑定到 Git 账户,或切换 HTTPS 协议重新认证。 |
| 冲突文件无法解决 | 使用 右键文件 → 使用我的版本/他人的版本 快速覆盖,或通过对比工具手动合并。 |
| 大文件提交卡顿 | 在 .gitignore 中排除二进制文件,或使用 Git LFS 管理大文件。 |
| 标签未同步到远程 | 推送时勾选 包含标签,或单独执行命令 git push --tags。 |
| 分支历史混乱 | 使用 交互式变基(右键分支 → 交互式变基)整理提交记录。 |
| SSH连接失败 | 检查密钥权限(chmod 600 ~/.ssh/id_ed25519) |
| 冲突解决 | 优先使用对比工具,避免直接覆盖他人代码。 |
| 强制推送 | 仅限个人分支使用,团队协作分支禁用。 |
| 大型仓库克隆 | 分模块克隆或使用--depth=1浅克隆加速。 |
| 软件更新 | 定期检查更新,避免兼容性问题(如Git 2.40+新特性支持)。 |
优化建议
-
界面与性能
- 启用深色模式(视图→主题)减少视觉疲劳。
- 排除大文件跟踪(
.gitignore中配置*.log, /bin/)。
-
协作规范
- 提交信息格式:采用语义化提交(如
feat: 新增登录功能)。 - 分支命名:按类型前缀分类(
feature/,bugfix/,hotfix/)。
- 提交信息格式:采用语义化提交(如
-
工具集成
- 配置第三方对比工具(Beyond Compare/Meld):
“工具→选项→比较→自定义”。
- 配置第三方对比工具(Beyond Compare/Meld):
参考链接
- 文档中心: Atlassian SourceTree Docs
- 社区支持: Atlassian Community
- 社区支持: SourceTree安装与使用
- 社区支持: SourceTree使用方法
- 社区支持: scourcetree的安装和条过注册