github 使用教程核心是学会基于 git 版本控制系统，在 github 平台完成代码仓库创建 本地代码提交 远程同步 分支管理 协作合并这套完整流程，github 本身是云端代码托管平台，底层依赖 git 这个本地版本管理工具，很多新手一开始会混淆，以为 github 就是 git，实际上 git 运行在电脑本地，github 是远程服务器，用来存放远程仓库，支持多人协作开发，开源项目托管，版本回溯，代码评审，issue 工单管理这些功能，不管是个人项目备份，还是团队联合开发，开源项目参与贡献，都可以通过这套流程完成。之所以需要学习 github 使用教程，是因为现在编程学习 项目求职 开源社区贡献基本都要求掌握这套工具，它不只是上传代码，更重要的能力是记录每一次代码修改历史，可以随时回退旧版本，多人并行开发的时候，通过分支避免互相覆盖代码，这也是它相比普通网盘上传文件最大的优势，网盘只保存文件，不会记录代码变更差异，也没有协作评审机制。学习的时候建议先掌握 git 基础命令，再衔接 github 网页端操作，网页端适合简单修改，复杂开发还是推荐本地 git 客户端搭配命令行或者图形化工具。
前期准备
| 项目 | 说明 |
|---|---|
| 必备软件 | git，windows mac linux 都可以安装对应版本 |
| 账号 | 注册 github 官方账号，绑定邮箱 |
| 身份配置 | 配置用户名和邮箱，提交记录会标记作者信息 |
| 可选工具 | 图形化客户端 SourceTree TortoiseGit，VSCode 内置 git 插件 |
基础概念说明
仓库 repository，也就是 repo，存放项目代码的容器，可以公开 public，任何人可以查看，也可以私有 private，只有授权用户访问。
commit 提交，本地一次代码变更记录，每次提交都需要写 commit message，说明这次修改内容。
branch 分支，独立开发副本，主分支一般是 main 或者 master，新功能开发新建分支，开发完成之后合并回主分支。
pull request 简称 PR，向原项目申请把自己分支代码合并进上游仓库，开源贡献最核心操作。
issue，项目工单，用来提交 bug 需求讨论，跟踪问题。
clone 克隆，把远程 github 仓库完整下载到本地电脑。
push 推送，把本地 commit 上传到远程 github 仓库。
pull 拉取，把远程 github 最新代码同步到本地，避免代码版本不一致。
完整实操步骤
第一步 注册 github 账号，登录网页端，新建仓库，填写仓库名称，选择公开或者私有，可选勾选自动生成 readme 说明文件，创建完成之后获取仓库远程地址，支持 https 或者 ssh 两种协议。
第二步 本地安装 git，打开终端，执行全局身份配置，设置用户名和邮箱。
第三步 选择项目目录，如果是全新项目，执行 git init 初始化本地仓库，如果是已有 github 项目，执行 git clone 远程地址，把仓库下载到本地。
第四步 修改代码之后，执行 git add，把改动文件加入暂存区，再执行 git commit，完成本地提交，提交信息写清楚本次改动。
第五步 执行 git push，把本地提交推送到 github 远程仓库，网页刷新之后就可以看到最新代码。
第六步 多人协作场景，新建开发分支，在分支上修改代码，开发完成之后在 github 网页发起 pull request，等待项目维护者审核，审核通过之后合并代码。
第七步 同步远程更新，其他人已经推送新代码的时候，本地执行 git pull 拉取最新版本，防止推送的时候出现冲突。
常见进阶功能
readme 文件，仓库首页展示项目介绍，安装方式 使用说明，开源协议 license，声明代码使用授权规则。
actions 自动化，github 内置 CI 能力，可以自动执行测试 打包部署。
release 版本发布，标记正式版本，上传安装包，适合软件项目对外发布。
fork 复刻，把别人开源项目复制一份到自己 github 账号，在自己副本修改之后再提交 PR 贡献代码。
常见问题处理
代码冲突，多人同时修改同一行代码，push 的时候会报错，需要手动合并冲突文件，解决之后重新提交推送。
权限报错，私有仓库没有授权，或者 ssh 密钥没有配置成功，会推送失败，可以检查密钥配置，或者临时切换 https 方式。
提交记录作者信息错误，需要修改 git 全局配置，必要的时候修正历史提交。
综合来看，github 使用教程学习顺序是先理解 git 核心概念，再掌握新建仓库 克隆 提交 推送 拉取 分支 PR 这套基础流程，之后再逐步学习 fork actions release 这类进阶功能，新手不要一开始就钻研复杂底层原理，优先跑通完整基础流程，在实际项目里面反复练习，才能熟练掌握 github。
【常见问题】
问题 1 github 使用教程 github 和 git 是同一个东西吗
回答 1 github 使用教程里面明确区分，git 是本地版本控制软件，github 是基于 git 的云端代码托管平台，二者不是同一个东西，github 底层依托 git 运行。
问题 2 github 使用教程 推送代码的时候出现冲突该怎么处理
回答 2 github 使用教程里提到代码冲突是多人协作常见报错，需要打开冲突文件手动合并修改内容，解决冲突之后重新 add commit 再执行 push。
问题 3 github 使用教程 fork 别人项目之后怎么贡献代码
回答 3 github 使用教程里面，fork 之后代码会复制到自己账号仓库，本地克隆自己 fork 的仓库修改代码，推送完成之后，向上游原项目发起 pull request 申请合并。
【免责申明】
本文为通用入门 github 使用教程，命令和界面会随 github 官方版本更新发生变化，平台规则 收费政策以 github 官方公告为准，本文仅作技术学习参考，不构成商业项目部署 开源合规相关建议。