github 是基于 git 版本控制系统搭建的在线代码托管平台，核心作用就是存放项目代码，记录每一次代码修改历史，支持多人协同开发，同时还可以用来开源项目展示，做静态网页部署，提交 issue 跟踪 bug，发起 pull request 合并代码，很多新手以为 github 只是单纯存代码的网盘，其实它的重点是版本管理和团队协作，本地电脑安装 git 工具之后，就可以把本地项目和 github 远程仓库关联，完成上传拉取更新分支合并这些操作，个人开发者可以创建公开仓库分享开源项目，私有仓库可以保存自己不对外公开的代码，团队项目可以给成员分配权限，多人同时开发不同分支，最后合并主干，学习 github 怎么用，先要分清本地 git 和远程 github 的关系，git 是本地命令工具，github 是远程服务器端平台，两者配合使用，下面会从注册环境准备，新建仓库，基础操作，分支协作，常用概念分层讲解，同时整理新手高频报错和常见疑问。
基础概念说明
repository 仓库，简称 repo，也就是一个项目的代码存储空间
commit 提交，代表一次代码变更记录，附带提交说明
branch 分支，独立开发线路，不影响主分支 main
main 主分支，项目正式稳定版本默认分支
pull request 简称 PR，把分支代码申请合并到主分支，供其他人评审
issue 工单，用来提 bug 需求讨论问题
clone 克隆，把远程 github 仓库完整下载到本地
push 推送，本地提交后的代码上传到 github 远程仓库
pull 拉取，把 github 远程最新代码同步到本地
使用前准备
1 注册 github 账号，填写用户名邮箱完成验证
2 本地电脑安装 git 软件，安装完成之后打开终端，配置全局用户名和邮箱
git config --global user.name 你的用户名
git config --global user.email 你的邮箱
3 推荐可选安装图形客户端，比如 gitkraken sourcetree，不习惯命令行可以用图形化方式操作 github
核心操作步骤
第一步 创建远程仓库
登录 github 网页，点击新建仓库，填写仓库名称，选择 public 公开或者 private 私有，可选初始化 README 文件，确认创建，创建完成页面会显示仓库远程地址，分为 https 地址和 ssh 地址
第二步 本地项目关联远程仓库
方式一 克隆已有仓库，在仓库页面复制地址，终端执行 git clone 仓库地址，代码就下载到本地
方式二 本地已有项目，进入项目文件夹，执行 git init 初始化本地 git 仓库，然后执行 git remote add origin 远程仓库地址，完成本地和 github 仓库绑定
第三步 代码提交推送
修改代码之后，执行 git add . 把所有改动加入暂存区
执行 git commit -m 提交说明文字 生成一次 commit 记录
执行 git push origin main 把本地代码推送到 github 远程 main 分支
第四步 同步远程更新
如果别人修改了 github 上面的代码，本地执行 git pull origin main，拉取远程最新代码到本地，避免推送冲突
第五步 分支开发与 PR 合并
新建分支 git checkout -b dev
在 dev 分支修改代码，add commit 之后 push 到 github
回到 github 网页，找到对应分支，发起 pull request，填写修改说明，等待评审，评审通过之后合并到 main 主分支
常用操作对比表格
| 操作 | 命令 | 作用 |
|---|---|---|
| clone | git clone url | 下载 github 远程仓库到本地 |
| add | git add . | 把改动加入暂存区 |
| commit | git commit -m msg | 生成本地版本提交记录 |
| push | git push origin 分支名 | 上传本地代码到 github |
| pull | git pull origin 分支名 | 从 github 拉取最新代码 |
| checkout | git checkout -b 分支名 | 新建并切换分支 |
进阶功能介绍
github pages，可以把仓库里面静态网页文件部署成公开访问网页，适合个人主页文档站点
actions 自动化流水线，代码 push 之后自动运行测试打包
wiki 项目文档页面，用来写项目说明文档
release 版本发布，给项目打标签发布正式版本
fork 复刻别人的开源仓库到自己账号下，修改之后再提交 PR 给原作者，这是开源贡献最常用方式
新手常见问题
1 推送提示权限失败，一般是 https 方式没有配置 token，或者 ssh 密钥没有添加到 github 账号
2 推送冲突，本地代码和远程代码修改同一行，需要手动解决冲突之后再提交
3 仓库太大，提交了大文件，push 很慢，可以使用 git lfs 管理大文件
4 误提交敏感信息，比如密码密钥，需要清理历史提交，不能只删除文件，旧 commit 里面仍然保留记录
【常见问题】
问题 1 github 是不是必须会命令行才能使用
回答 1 不是，github 网页端本身可以直接编辑文件，也可以搭配图形化 git 客户端，github 怎么用不一定强制使用命令行，只是命令行方式功能最完整，团队开发推荐熟悉基础命令。
问题 2 github 公开仓库和私有仓库有什么区别
回答 1 github 公开仓库所有人都可以浏览克隆代码，私有仓库只有授权成员可以访问，学习 github 怎么用的时候，个人练习项目可以选公开，涉及商业代码就选择私有仓库。
问题 3 fork 别人仓库之后怎么把修改提交回原项目
回答 1 fork 之后代码在你自己 github 账号仓库，修改完成推送，然后在原项目仓库发起 pull request，这是 github 开源协作标准流程，也是 github 怎么用里面非常重要的开源贡献操作。
问题 4 github 和 gitee 有什么不一样
回答 1 github 是海外平台，生态开源项目数量更多，访问有时候不稳定，gitee 是国内代码托管平台，访问速度更快，基础逻辑和 github 类似，学会 github 怎么用之后，迁移到同类平台操作思路基本相通。
【免责申明】
本 github 怎么用教程仅作为技术学习参考，请遵守 github 官方用户协议，不要上传侵权代码违法内容，平台功能界面和政策会随官方更新发生变动，因网络环境账号权限操作失误产生的问题，由使用者自行承担责任。