GitHub 入门

这一课你将能做到

1. 把本地仓库通过 git remote add 关联到 GitHub，并用 git push -u 首次推送
2. 说清 origin、origin/main、本地 main 三者的关系
3. 用 SSH 或 Personal Access Token 完成 GitHub 身份认证

为什么要学

Git 是本地工具，GitHub 是云端协作平台。没有 GitHub，你的代码只在自己电脑上——硬盘坏了全完，也没法和队友协作。把代码推上 GitHub 后，你获得了：异地备份、多人协作、Pull Request 评审、Issues 管理、CI/CD 自动化、开源展示（简历加分项）。

本站 java-nav 的代码就托管在 GitHub，你看到的课程、路线图，都是通过 Git 工作流合并进主干的。

先建立图像

本地与远程的对应关系：

你的电脑                                GitHub 云端
┌─────────────────────┐                ┌─────────────────────┐
│ 工作区 → 暂存区 → 本地仓库 │  push      │ 远程仓库 origin        │
│                main │ ─────────────> │                main │
│                     │ <───────────── │                     │
│  远程跟踪分支          │  fetch/pull   │                     │
│  origin/main（只读）  │                │                     │
└─────────────────────┘                └─────────────────────┘

关键概念：origin 是远程仓库的默认别名；origin/main 是你本地缓存的「远程 main 长什么样」的快照，只读，不随你的提交变化。

跟着做

步骤 1：注册 GitHub 并创建远程仓库

1. 访问 github.com 注册账号
2. 右上角 + → New repository
3. 仓库名填 git-demo，选 Public，不要勾选「Initialize with README」（避免首次 push 冲突）
4. 创建后页面会显示仓库地址，形如 https://github.com/你的用户名/git-demo.git

步骤 2：配置认证（SSH 推荐）

# 生成 SSH 密钥（一路回车）
ssh-keygen -t ed25519 -C "zhangsan@example.com"

# 查看公钥内容
cat ~/.ssh/id_ed25519.pub

复制输出的整串（ssh-ed25519 AAAA...），打开 GitHub → Settings → SSH and GPG keys → New SSH key，粘贴保存。

验证：

ssh -T git@github.com
# Hi zhangsan! You've successfully authenticated...

步骤 3：关联远程仓库

回到第一课创建的本地 git-demo 目录：

cd git-demo
git remote add origin git@github.com:你的用户名/git-demo.git
git remote -v
# origin  git@github.com:你的用户名/git-demo.git (fetch)
# origin  git@github.com:你的用户名/git-demo.git (push)

git remote -v 验证关联成功。