GitHub 基础入门：账号注册与 SSH 密钥配置详解

查看与修改配置

# 查看所有配置
git config --list

# 查看当前仓库的局部配置
git config --local --list

# 修改已有配置（直接重新输入命令覆盖）
git config --global user.email "[email protected]"

# 删除某项配置
git config --global --unset user.email

3. SSH 配置

为了免密登录并保障安全，推荐使用 SSH 密钥代替 HTTPS 密码验证。HTTPS 方式若密码泄露存在风险，而 SSH 基于密钥对验证更安全。

检查是否已有 SSH 密钥

ls -al ~/.ssh

如果看到 id_rsa 或 id_ed25519 等文件，说明已有密钥；如果没有，继续下一步。

生成新的 SSH 密钥

# 推荐格式（RSA）
ssh-keygen -t rsa -b 4096 -C "[email protected]"

# 或者（ED25519）
ssh-keygen -t ed25519 -C "[email protected]"

执行后按提示操作：

1. 保存路径：直接回车使用默认路径
2. 设置密码（Passphrase）：新手建议直接回车留空，免密更便捷；如需更高安全可设密码
3. 确认密码：再次回车

密钥路径说明

• 私钥（绝对保密）：~/.ssh/id_rsa 或 ~/.ssh/id_ed25519
• 公钥（需上传至 GitHub）：~/.ssh/id_rsa.pub 或 ~/.ssh/id_ed25519.pub

启动 SSH 代理

# 启动代理
eval "$(ssh-agent -s)"

# 添加私钥到代理
ssh-add ~/.ssh/id_rsa
# 或使用 ed25519
ssh-add ~/.ssh/id_ed25519

复制公钥到剪贴板

不同系统复制命令不同：

# Windows (Git Bash)
clip < ~/.ssh/id_rsa.pub

# Linux
xclip -sel clip < ~/.ssh/id_rsa.pub

# macOS
pbcopy < ~/.ssh/id_rsa.pub

登录 GitHub 粘贴公钥

1. 点击右上角头像 → Settings（设置）
2. 左侧菜单找到 SSH and GPG keys
3. 点击 New SSH key
4. 填写信息：
   • Title：自定义名称（如'我的笔记本'）
   • Key type：Authentication Key
   • Key：粘贴刚才复制的公钥内容
5. 点击 Add SSH key，可能需要输入 GitHub 密码验证

验证 SSH 是否成功

回到终端执行：

ssh -T [email protected]

首次连接会提示 Are you sure you want to continue connecting?，输入 yes 回车。

常见问题排查：

如果遇到报错，常见原因包括：

• 公钥复制不完整（多了空格或少了行）
• 生成密钥的邮箱与 GitHub 不一致
• 私钥未添加到代理（重新执行 ssh-add）
• 网络端口限制

如果是国内网络环境遇到连接超时，可能需要配置 SSH 配置文件使用 443 端口：

vim ~/.ssh/config

在文件中添加以下内容：

Host github.com
    HostName ssh.github.com
    Port 443
    User git

保存退出（:wq），并设置权限：

chmod 600 ~/.ssh/config

再次执行 ssh -T [email protected] 验证，看到欢迎信息即表示配置成功。