准备工作与基础安装
在把本地项目推送到GitHub之前，你需要先在电脑上装好Git。Windows和Mac系统都可以通过官网下载对应安装包，安装过程一路点击下一步即可。装完后打开终端或命令提示符，输入git version查看版本号。如果能显示出版本信息，说明环境已经就绪。Linux用户通常自带Git，只需通过包管理器更新到最新版本就能直接使用。
设置全局用户名与邮箱
每次提交代码时，Git都会记录是谁提交的。为了匹配你的GitHub账号，必须配置全局的用户名和邮箱。打开命令行，依次运行配置命令。第一行替换为你在GitHub注册的名字，第二行替换为你注册时绑定的邮箱。设置完成后建议执行一条查询命令，确认信息已经保存成功。这一步不做的话，后续推送代码会直接报错，而且历史提交记录也会找不到对应的作者。
生成SSH密钥对
为了让本地电脑和GitHub建立安全信任，我们需要生成一对SSH密钥。在命令行输入生成命令后，程序会提示你按三次回车键，表示不设置密码且使用默认存储路径。等进度条走完，你会看到一串字符，这就是公钥的内容。注意不要漏掉末尾的邮箱地址部分。如果你平时只用一台电脑做开发，保持默认设置是最省事的方案，也能减少后续维护的麻烦。
将公钥添加到GitHub后台
登录你的GitHub账号，点击右上角头像选择设置。进入开发者设置里的SSH和GPG密钥页面，点击新建密钥按钮。把刚才复制的那段长字符串粘贴到密钥框里，标题随便填一个能记住的名字。保存之后，GitHub就会识别你的电脑了。这一步非常关键，公钥相当于给你的设备发了通行证，没有它就无法免密传输代码。粘贴前一定要仔细核对，首尾不要多出空格。
验证连接是否成功
添加完公钥后别急着传文件，先测试一下通道是否通畅。在命令行输入测试命令，第一次运行时会问你是否继续连接，输入yes并回车即可。如果返回的文字里包含欢迎字样，说明网络握手已经成功，接下来可以正式操作代码仓库。如果提示连接超时，请检查防火墙设置或企业内网的代理策略，确保端口放行正常。
克隆与推送代码流程
如果想把别人的项目拉到本地，直接使用clone命令加上仓库网址就行。如果是自己创建的新项目，先在GitHub网页端建好空仓库，拿到SSH链接。切换到本地项目文件夹，初始化版本库，然后添加所有文件并提交一次。最后指定远程仓库地址并推送代码。完成这一步后去网页刷新，就能看到刚上传的文件了。日常开发中养成小步快跑的习惯，频繁提交比攒一堆改动再一次性上传要安全得多。记得在项目根目录放一个.gitignore文件，把编译生成的临时文件和依赖库排除在外，保持仓库干净。
分支管理与协作规范
实际项目中很少直接在主分支上改代码。推荐先创建功能分支，做完测试后再合并回主分支。这样既能保护核心代码稳定，也方便多人协同。遇到合并冲突时不要慌，Git会明确标出冲突位置，手动修改保存后重新提交即可。定期同步上游仓库的最新提交，能大幅减少后期合并的痛苦。配合简单的注释规范，团队代码审查会变得轻松很多。
常见报错与解决技巧
新手最容易遇到权限拒绝的问题。如果发现推送失败，多半是用了HTTPS链接但没输入账号密码，或者SSH配置没生效。建议统一改用SSH地址，并在命令行用配置文件管理多账号。另外，如果提示分支落后于远程，记得先用pull拉取最新内容再合并，避免冲突。遇到网络超时可以先检查代理设置，国内用户偶尔需要切换DNS或更换镜像源。掌握这些排错方法后，你就能独立应对绝大部分的连接问题，开发流程也会越来越顺畅。
