第 7 章 · GitHub 远程：克隆、关联与令牌
本章目标：申请并安全使用 GitHub 访问令牌（PAT）；分清 从 GitHub 克隆 与 关联本地并拉取；完成 克隆 → 改 README → 提交 → 推送 → 网页验收 全链路；会填 Git 身份 表单。
学时建议：3.5～4 小时（含 2 小时跟练）
前置：git-collab ch02（打开项目、色标）；有 GitHub 账号。
7.1 场景说明：代码在 GitHub，你电脑还没有
Leader 发来仓库地址：https://github.com/your-org/shop-demo.git
你的情况可能是：
| 情况 | 你该用 |
|---|---|
| 电脑上是空文件夹，还没有代码 | 从 GitHub 克隆 |
| 本地已有项目，GitHub 刚建了空仓库 | 关联本地并拉取 |
| 已在 ch01 打开过本地 shop-demo | 本章用 关联 或继续用已有 remote |
GitHub 不再接受账号密码推送，推拉都要 PAT（或 SSH 密钥——本章以 PAT + HTTPS 为主，与工作台提示一致）。
7.2 学完你能
| 能力 | 验收 |
|---|---|
| 申请 PAT | Contents 读写权限 |
| 克隆 | 空目录 → 工作台自动/手动打开项目 |
| 关联 | 已有文件夹接上 remote |
| 推送 | GitHub 网页能看到 commit |
| 安全 | 令牌不进仓库、不写进代码 |
| 身份 | 提交不再报 author unknown |
7.3 PAT 是什么、怎么申请
Personal Access Token = 代替密码的一串密钥，可设权限和过期时间。
步骤（GitHub 网页）：
- 登录 GitHub → 右上角头像 → Settings
- 左侧最下 Developer settings → Personal access tokens → Tokens (classic) 或 Fine-grained（团队有规定跟团队）
- Generate new token
- 勾选至少：repo（classic）或 Contents: Read and write（fine-grained）
- 生成后 立刻复制——页面关闭后不再显示
保管规则：
- 存密码管理器或本机安全笔记，不要 commit 到 Git
- 泄露 → GitHub 上 Revoke 作废 → 重建
- 勿截图发群聊
工作台何时要 PAT：克隆、推送、拉取 弹出认证时，用户名填 GitHub 用户名，密码处粘贴 PAT（不是登录密码）。
7.4 克隆 vs 关联：一张表记牢
| 方式 | 本地状态 | 菜单（名称以界面为准） | 结果 |
|---|---|---|---|
| 从 GitHub 克隆 | 目标路径空目录 | 从 GitHub 克隆 | 下载整仓 + 通常自动打开项目 |
| 关联本地并拉取 | 文件夹里已有代码 | 关联本地并拉取 | 绑定 remote，首次 pull/push |
| 打开已有克隆 | 之前克隆过 | 项目 → 打开项目 | 继续开发 |
常见误操作：克隆到非空目录 → 失败；换空目录或删光测试目录（勿删有内容的工程）。
7.5 跟练 A：从 GitHub 克隆（推荐新手完整走一遍）
步骤 1 — GitHub 建仓库
浏览器：New repository → 名 shop-demo-learn（或自用名）→ 可选 README → Create。
复制 HTTPS 地址，形如 https://github.com/你的用户名/shop-demo-learn.git
步骤 2 — 本地准备空目录
mkdir -p ~/dev-workspace/shop-demo-learn
# 确认空：ls -la 应只有 . ..步骤 3 — 工作台克隆
仓库 → GitHub 远程仓库 → 从 GitHub 克隆
- 仓库 URL：粘贴 HTTPS 地址
- 本地路径：
~/dev-workspace/shop-demo-learn（或你选的空路径） - 提示认证：用户名 + PAT
你应该看到：进度完成；左侧文件树出现 README.md 等；可能自动打开该项目。
步骤 4 — 色标检查（ch02）
打开的是仓库根（含 .git 的那层），文件树应有 Git 色标（M/U 等能力可用）。
步骤 5 — Git 身份（若弹窗）
首次 提交 可能要求：
- Git 用户名（可与 GitHub 显示名一致）
- Git 邮箱（建议 GitHub 账号绑定邮箱）
填一次后本项目可正常 commit。工作台不会擅自改你系统全局 Git 配置。