GitHub：远程仓库与协作流程

这一课你将能做到

1. 把本地仓库推送到 GitHub，完成 push/pull/clone 的完整远程操作
2. 发起和审查 Pull Request，用分支协作避免直接在 main 上开发
3. 用 GitHub Pages 部署静态页面，让项目直接可访问

为什么要学

Git 管本地版本，GitHub 管远程协作。你的代码不能只存在自己电脑上——硬盘会坏、电脑会丢、你需要在不同设备上工作，更重要的是团队协作必须有一个「中央仓库」作为信源。

GitHub 不只是代码托管，它是现代软件开发的基础设施：Issue 跟踪 bug、Pull Request 做代码审查、Actions 做自动化测试和部署、Pages 做免费静态托管。不会 GitHub，你就无法参与真实的团队开发。

先建立图像

本地仓库（你的电脑）
    ↑↓ git push / git pull
远程仓库（GitHub）
    ↑↓ fork / PR
上游仓库（团队主仓库）

个人开发时，本地和远程是一对一同步。团队协作时，每个人 fork 或 clone 中央仓库，通过 Pull Request 把代码合回去。

跟着做

步骤 1：创建远程仓库

1. 登录 github.com，点击右上角 + → New repository
2. 填写仓库名（如 my-first-repo），选择 Public（开源）或 Private（私有）
3. 不要勾选 "Initialize this repository with a README"（我们本地已有仓库）
4. 创建后看到提示页面，复制 HTTPS 地址（如 https://github.com/用户名/my-first-repo.git）

步骤 2：本地仓库关联远程并推送

# 进入本地已有的 Git 仓库
cd my-project

# 关联远程仓库（origin 是默认别名）
git remote add origin https://github.com/用户名/my-first-repo.git

# 把本地 main 分支推送到远程（-u 建立追踪关系）
git push -u origin main

# 输入 GitHub 用户名和个人访问令牌（Token）
# 注意：GitHub 已废弃密码登录，必须用 Token

获取 Token：GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token，勾选 repo 权限。

步骤 3：日常推拉流程

# 开始工作前先拉取最新代码
git pull origin main

# 开发、提交（和本地流程一样）
git add .
git commit -m "添加新功能"

# 推送到远程
git push origin main

如果远程有更新你本地没有，push 会被拒绝。先 git pull 合并远程更改，再 push。

步骤 4：克隆已有仓库

如果你想在另一台电脑或新目录开始工作：

# 克隆到本地
git clone https://github.com/用户名/my-first-repo.git

# 进入项目
cd my-first-repo

# 查看远程地址
git remote -v

clone 会自动创建文件夹、初始化 Git、关联远程、下载所有历史。

步骤 5：Pull Request 协作流程

Pull Request（PR）是团队协作的核心机制：不在 main 上直接提交，所有改动通过 PR 审查后再合并。

# 1. 创建功能分支
git switch -c feature-navbar

# 2. 开发并提交
git add .
git commit -m "Add responsive navbar"

# 3. 推送分支到远程
git push -u origin feature-navbar

# 4. 在 GitHub 网页上点击 "Compare & pull request"
# 5. 填写 PR 标题和描述，请求审查
# 6. 审查者评论、要求修改
# 7. 修改后再次 push，PR 自动更新
# 8. 审查通过，点击 "Merge pull request"
# 9. 删除远程分支，本地执行 git switch main && git pull