Sourcetree 拉取新工程

下面分两种场景：首次把远程工程拿到本地（克隆） 、本地已有时，拉取远程最新更新（拉取）。

一、首次拉取（克隆）远程工程到本地

适用于：你电脑上还没有这个项目，需要从 0 拉下来。

1. 获取远程仓库地址

   • 打开 GitHub/GitLab/Gitee 等项目页面
   • 点击「克隆 / 下载」，复制 HTTPS 或 SSH 地址。

SourceTree 中克隆

• 打开 SourceTree → 点击 Clone/New （文件→克隆 / 新建）。
• 在「Source URL」粘贴刚才复制的远程地址。
• 「Destination Path」选择本地存放目录（建议空文件夹）。
• 「Name」填项目名（自动生成，可改）。
• 

• • 点击 Clone，等待下载完成。

• 验证

  • 左侧会出现该仓库，双击进入，能看到所有文件和提交记录。

二、本地已有工程，拉取远程最新代码（Pull）

适用于：你本地已经有这个项目，要同步别人刚提交的代码。

1. 切换到正确分支

   • 左上角分支下拉框，切到你要更新的分支（如 main /master/dev）。

拉取（Pull）

• 点击顶部工具栏 Pull（拉取）按钮。

在弹出框：

• 远程分支一般选 origin/当前分支
• 勾选「合并后跟踪远程分支」（可选）
• 点击 Pull。

1. 结果

   • 提示「Pull completed」即成功，本地代码已更新到最新。
   • 若有冲突，会提示文件冲突，需手动解决后再提交。

---

三、常用概念区分（新手必看）

• 克隆（Clone）：第一次把远程整个仓库下载到本地（只做一次）。
• 获取（Fetch） ：只下载远程更新记录，不合并到本地代码（安全查看）。

• 拉取（Pull）：= Fetch + 自动合并（日常更新用这个）。

---

四、常见问题

1. 认证失败（HTTPS）

   • 首次拉取会弹窗，输入你 Git 账号的用户名 / 密码（或个人访问令牌）Atlassian。

2. SSH 拉取失败

   • 需先配置 SSH 密钥：ssh-keygen -t rsa → 把 id_rsa.pub 内容粘贴到网站的 SSH Keys 设置里。

3. 提示 "不是标准 Git 仓库"

   • 地址错了 / 没权限 / 仓库是空的 → 核对地址、申请权限。