GitHub 账号注册后 5 项必做设置从基础安全到高效协作刚注册完 GitHub 账号的你可能正兴奋地准备开始第一个开源项目或是想为公司团队搭建代码仓库。但先别急着创建第一个 repository——就像搬进新家要先检查门窗锁具一样你的 GitHub 账号也需要一套完整的安全与效率配置。这些设置看似琐碎却能让你在未来的协作中少踩 80% 的坑。1. 双重认证2FA给账号加上防盗门在 2023 年 GitHub 强制要求活跃开发者启用 2FA 之前主动设置它就像给数字身份买了保险。我见过太多开发者因为仅用密码验证导致多年贡献的代码库一夜之间被恶意删除。以下是具体操作点击右上角头像 →Settings→ 左侧菜单选择Password and authentication在Two-factor authentication区域点击Enable 2FA推荐使用Authenticator app如 Google Authenticator 或 Microsoft Authenticator比短信验证更安全扫描二维码后系统会要求输入 6 位验证码完成绑定关键细节务必立即下载显示的恢复代码并保存在安全位置如密码管理器团队账号建议使用安全密钥YubiKey 等物理设备作为 2FA 方式启用后API 调用也需要 2FA 验证记得更新自动化脚本注意如果使用 GitHub Mobile 应用可以在设置中开启「应用内认证」避免频繁输入验证码2. SSH 密钥配置告别频繁的密码输入每次 push 代码都要输密码SSH 密钥对能让你像使用门禁卡一样优雅地验证身份。通过终端生成密钥只需 3 步# 生成新密钥替换your_emailexample.com ssh-keygen -t ed25519 -C your_emailexample.com # 将密钥添加到ssh-agent eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519 # 复制公钥内容显示在终端后手动复制 cat ~/.ssh/id_ed25519.pub然后在 GitHub 设置页面的SSH and GPG keys部分粘贴公钥。测试连接是否成功ssh -T gitgithub.com进阶技巧为不同设备生成独立密钥对便于权限管理使用ssh-add -K在 macOS 上将密钥永久添加到钥匙串遇到「Permission denied」错误时检查~/.ssh/config文件是否包含正确配置3. GPG 签名提交给代码盖上个人印章当团队有多个贡献者时如何确认 commit 确实来自你本人GPG 签名就像代码的电子签名。配置流程步骤命令/操作说明1gpg --full-generate-key选择 RSA 4096 位密钥2gpg --list-secret-keys --keyid-format LONG查看生成的密钥 ID3git config --global user.signingkey [密钥ID]设置全局签名密钥4git config --global commit.gpgsign true开启自动签名将公钥通过gpg --armor --export [密钥ID]获取添加到 GitHub 账户后所有提交都会显示「Verified」标记。常见问题解决方案如果遇到「error: gpg failed to sign the data」在.zshrc或.bashrc添加export GPG_TTY$(tty)丢失私钥需要撤销旧密钥并生成新密钥对4. 通知设置优化过滤代码「噪音」默认设置下参与的项目每个动态都会轰炸你的邮箱。按这样调整能节省 70% 的无效通知进入Settings → Notifications在「Default notifications」选择Custom→ 仅勾选「Participating and mentions」在「Automatically watch」选择Dont automatically watch anything启用「Notification email preferences」中的摘要功能高效协作技巧为重要仓库单独设置 watch 级别使用[团队名]提及而非单独 成员在移动端安装 GitHub 应用开启推送通知5. 仓库默认保护设置防患于未然新建仓库时这些设置能避免后续麻烦分支保护规则Branch protection rules要求 Pull Request 通过后才可合并要求状态检查通过包括管理员在内的强制推送限制自动化安全更新启用 Dependabot 自动依赖更新开启秘密扫描Secret scanning默认分支命名将main而非master设为默认分支团队最佳实践# 快速修改现有仓库的默认分支 git branch -m master main git push -u origin main git push origin --delete master配置完成后你的 GitHub 账号已经从「裸机」升级为「装甲车」。这些设置平均需要 30 分钟完成但能为未来节省数百小时的问题排查时间。现在当你点击「New repository」时才能真正专注于代码本身的价值创造。