GitHub 账户配置指南
GitHub 账户配置指南
从注册到本地关联，一步步来，10 分钟搞定。
一、注册 GitHub 账号
- 打开 github.com，点击 Sign up
- 填写邮箱、密码、用户名（用户名会出现在你的仓库地址里，建议简洁好记）
- 完成邮箱验证
用户名建议如果你以后可能用 GitHub 存论文代码，建议用真名或学术常用名，方便同行找到你。
二、安装 Git
| 系统 | 安装方式 |
|---|---|
| Mac | 打开终端（Terminal），输入 git --version，如果没装会自动提示安装 |
| Windows | 去 git-scm.com 下载安装包，一路下一步即可 |
验证安装成功：
git --version
# 输出类似：git version 2.43.0
三、配置本地 Git 身份
告诉 Git 你是谁（只需要做一次）：
git config --global user.name "你的名字"
git config --global user.email "你注册GitHub用的邮箱"
验证配置：
git config --global --list
# 应该能看到 user.name 和 user.email
四、配置 SSH 密钥（推荐）
SSH 密钥让你推送代码到 GitHub 时不用每次输密码。
4.1 生成密钥
ssh-keygen -t ed25519 -C "你的邮箱"
连按三次回车（使用默认路径，不设密码）即可。
4.2 复制公钥
Mac：
pbcopy < ~/.ssh/id_ed25519.pub
Windows（Git Bash）：
clip < ~/.ssh/id_ed25519.pub
如果上面的命令不好使直接运行
cat ~/.ssh/id_ed25519.pub，然后手动复制输出的内容。
4.3 添加到 GitHub
- 打开 GitHub → 右上角头像 → Settings
- 左侧菜单点 SSH and GPG keys
- 点 New SSH key
- Title 随便填（比如"我的 MacBook"），Key 里粘贴刚才复制的公钥
- 点 Add SSH key
4.4 验证连接
ssh -T git@github.com
如果看到 Hi 你的用户名! You've successfully authenticated... 就说明配置成功了。
五、创建你的第一个仓库
方式一：在 GitHub 网页上创建（推荐新手）
- 登录 GitHub，点右上角 + → New repository
- 填写仓库名（比如
my-first-project） - 勾选 Add a README file
- 点 Create repository
- 把仓库克隆到本地：
git clone git@github.com:你的用户名/my-first-project.git
cd my-first-project
方式二：把本地已有项目推送到 GitHub
- 在 GitHub 上创建一个空仓库（不要勾选 README）
- 在本地项目目录运行：
git init
git add .
git commit -m "初始化项目"
git remote add origin git@github.com:你的用户名/仓库名.git
git push -u origin main
六、日常使用流程
配置完成后，日常只需要：
# 写代码、改代码……
git add . # 选中改动
git commit -m "添加了xxx功能" # 存档
git push # 推送到 GitHub
七、常见问题
Q: push 时提示 permission denied
检查 SSH 密钥是否配置正确：
ssh -T git@github.com
如果失败，重新走一遍第四步。
Q: push 时提示 remote origin already exists
说明你之前已经设置过远程仓库了，先删除再重新添加：
git remote remove origin
git remote add origin git@github.com:你的用户名/仓库名.git
Q: 分不清 HTTPS 和 SSH 地址
- SSH 地址（推荐）：
git@github.com:用户名/仓库名.git - HTTPS 地址：
https://github.com/用户名/仓库名.git
如果你配置了 SSH 密钥，就用 SSH 地址，不用每次输密码。
Q: 国内访问 GitHub 很慢怎么办
可以考虑设置代理，或者使用 Gitee（国内的 GitHub 替代品）作为镜像。