很多刚接触版本控制的朋友在第一次把本地代码推送到GitHub时都会遇到各种报错。其实Git和GitHub的连接流程并不复杂，只要按步骤操作一次就能彻底掌握。这篇教程会带你从零开始，完成环境检查、身份配置、密钥生成以及首次代码推送的全过程，全程使用大白话讲解，避开晦涩的专业术语。
第一步安装Git并验证环境
如果你的电脑还没有安装Git，需要先下载对应系统的安装包。Windows用户去官网下载后一路点击下一步即可，Mac和Linux用户通常可以通过终端命令直接安装。安装完成后打开命令行工具，输入git version查看版本号。只要屏幕上显示出版本信息，就说明基础环境已经就绪，可以进入下一步设置。
第二步配置全局用户名和邮箱
每次提交代码时，Git都需要记录是谁写的这段代码。你需要用命令行告诉Git你的身份信息。打开终端或命令行窗口，分别执行两条命令。第一条是设置用户名，替换成你在GitHub上注册的真实名称。第二条是设置邮箱，务必填写你绑定GitHub账号的常用邮箱。这两条信息只会保存在本地电脑里，不会公开显示，但必须和GitHub后台的信息保持一致，否则后续推送时会提示权限错误。
第三步生成SSH密钥并添加到GitHub
这是最关键的一步。传统方式需要每次都输入账号密码，而使用SSH密钥可以实现免密连接。在终端中输入生成密钥的命令，文件路径保持默认即可，回车后会让你设置一个密码短语，直接连敲三次回车保持空白就行。接着运行查看公钥的命令，屏幕会输出一长串以ssh开头的字符。全选并复制这串字符，登录GitHub网页版，点击右上角头像找到设置选项，进入SSH和GPG keys页面，点击新建密钥，粘贴刚才复制的内容并保存。这一步相当于把你的电脑钥匙交给GitHub服务器备案。
第四步测试连接是否成功
配置完密钥后不要急着写代码，先做个连通性测试。在终端输入测试命令，系统会提示你是否信任该主机，输入yes并回车。如果看到Successfully authenticated字样，说明本地电脑和GitHub之间的通道已经完全打通。如果提示找不到文件或权限被拒，请回头检查密钥是否真的添加到了GitHub后台，或者重新生成一次。
第五步克隆仓库与推送代码
连接成功后就可以正式使用了。先在GitHub网页上创建一个新的空仓库，获取它的SSH地址。回到本地文件夹，用git clone命令加上那个地址，把远程仓库拉取到电脑上。进入项目目录后，把你的源代码放进去，依次执行添加改动、提交描述和推送的代码命令。注意推送前确保当前分支名称和GitHub一致，第一次推送可能需要加上强制指定分支的参数。一切顺利的话，刷新GitHub页面就能看到更新后的代码文件。
日常使用避坑指南
日常开发中难免会遇到分支管理混乱的情况。建议在每次开新需求前都创建一个独立分支，这样既能保护主分支稳定，又方便回滚操作。如果不小心误删了本地未推送的提交，可以通过reflog命令找回历史快照。另外GitHub现在也支持网页端直接编辑文件和发起Pull Request，适合处理简单的文档修改或小修小补。遇到push失败时不要慌张，先看终端报错的具体代码，百分之九十的问题都能通过rebase或强制推送解决。熟练之后你会发现自己完全不需要依赖复杂的集成开发环境，纯命令行操作反而更加清晰可控。掌握这些核心逻辑后，团队协作中的代码审查和合并请求流程也能轻松上手。
