1. 从零开始配置SSH密钥第一次用Git往GitHub私有仓库传文件时我卡在SSH配置这关整整两小时。现在回想起来其实就三个关键步骤生成密钥、添加密钥到ssh-agent、把公钥贴到GitHub账户。但当时没人告诉我这些细节走弯路是必然的。先打开终端Windows用户用Git Bash输入这个生成密钥的命令ssh-keygen -t ed25519 -C your_emailexample.com这里有个坑很多人习惯用默认的rsa算法但现在GitHub官方推荐ed25519安全性更高。敲完命令后连续按三次回车别设密码除非你对安全性有特殊要求这样就能在~/.ssh目录下看到id_ed25519和id_ed25519.pub两个文件。接着启动ssh-agent并添加私钥eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519我遇到过ssh-add报错的情况这时候需要先执行chmod 600 ~/.ssh/id_ed25519给密钥文件设置权限。最后把公钥内容复制到GitHubSettings → SSH and GPG keys → New SSH key。这里要注意用cat命令查看.pub文件时千万别漏掉开头或结尾的字符我有次就因为这个折腾半天连不上。2. 初始化本地仓库的正确姿势新建项目文件夹后很多人直接git init就完事了其实有几个隐藏配置能让你后续操作更顺畅。我的标准操作流程是这样的mkdir my_project cd my_project git init git config --local user.name 你的GitHub用户名 git config --local user.email 注册GitHub的邮箱为什么要单独设置local级别的config因为如果你同时在处理公司和个人项目全局配置会导致commit作者信息混乱。我吃过这个亏后来不得不批量修改历史记录。添加文件时别只会用git add .这个命令会把所有文件包括编译生成的临时文件都加进去。更专业的做法是先创建.gitignore文件然后git add *.py # 明确指定要添加的文件类型 git add src/ # 或者按目录添加commit信息也有讲究新手常犯的错误是写update或fix这种毫无信息量的message。好的commit应该像这样git commit -m feat: 添加用户登录验证功能 - 实现JWT token生成 - 增加密码加密逻辑3. 解决non-fast-forward错误的实战第一次执行git push -u origin main看到non-fast-forward报错时我整个人是懵的。其实这是因为远程仓库已经有初始文件比如README.md或LICENSE而你的本地仓库历史与其不匹配。官方文档给的解决方案是先fetch再merge但实测下来更稳妥的做法是git pull --rebase origin main这个命令相当于把本地的commit临时拿下来同步远程最新代码后再把你的commit放回去。有冲突的话会提示你解决比直接merge更干净。我后来才明白原理git pull默认采用merge策略会产生额外的merge commit而--rebase会重写commit历史保持线性更整洁。不过要注意已经push到远程的commit不要rebase会引发更复杂的问题。4. 处理no upstream branch问题当看到no upstream branch报错时说明Git不知道应该把本地分支和远程哪个分支对应起来。这时候有两个解决方案第一种是显式建立关联推荐git push --set-upstream origin main这个命令会完成两件事把本地main分支推送到远程origin仓库同时建立追踪关系。之后直接git push就能自动找到对应的远程分支。第二种方法是先手动设置上游分支git branch -u origin/main main我更喜欢第一种方式因为更符合操作直觉。不过要注意分支命名一致性有些仓库默认分支叫master有些叫main用git branch -a查看清楚再操作。5. HTTPS和SSH的选择策略虽然教程用SSH做演示但实际开发中HTTPS也有其适用场景。这两种协议的主要区别特性SSHHTTPS认证方式密钥对账号密码/Personal Token速度更快二进制协议稍慢HTTP协议防火墙兼容性可能被拦截22端口通常放行443端口多账号管理需配置多个密钥直接切换账号即可个人建议日常开发用SSH更高效但在CI/CD环境或临时协作时HTTPSPersonal Token更方便。切换协议用这个命令git remote set-url origin gitgithub.com:user/repo.git # SSH git remote set-url origin https://github.com/user/repo.git # HTTPS6. 私有仓库的特殊注意事项和公开仓库不同私有仓库有些额外安全设置会影响推送仓库权限检查确保你的账号有Write权限。我有次用公司账号配置了SSH但实际要推的是个人账号的仓库死活push不上去双因素认证影响如果开启了2FAHTTPS方式需要用Personal Token代替密码网络限制有些公司网络会拦截Git协议这时候需要配置代理注意仅指企业内网代理不涉及其他内容推送前建议先用这个命令测试SSH连接ssh -T gitgithub.com看到Hi username!的欢迎语就说明配置正确。如果失败可以加-v参数查看详细日志ssh -vT gitgithub.com7. 进阶技巧处理复杂分支场景当项目规模变大时分支管理会更复杂。这几个命令能帮你理清思路查看所有分支关系git show-branch -a推送特定本地分支到远程git push origin local_branch:remote_branch删除远程分支慎用git push origin --delete branch_name我习惯在push前先执行git remote show origin它能显示远程仓库的所有分支及其追踪状态避免误操作。另外定期执行git fetch --prune可以清理本地记录的已删除远程分支。