一、前言

本文讲解最标准、最简单、零翻车的 Git 命令行上传代码到 GitHub 完整流程，适合新手、零基础开发人员。无需任何可视化工具，纯终端命令完成新项目首次上传、代码更新、远程关联，是开发必备基础技能。

二、前期准备

1. 电脑安装 Git（Windows/Mac 均可）

2. 注册 GitHub 账号

3. GitHub 新建空仓库（不要勾选 README、License，避免首次提交冲突）

4. 复制仓库 HTTPS 地址 / SSH 地址

三、完整提交流程（标准6步法）

1. 终端进入本地项目根目录

cd 你的项目文件夹路径

示例：

cd /Users/xtool_ios/Desktop/MyIOSProject

作用：让终端定位到当前要上传的项目根目录。

2. 初始化本地 Git 仓库

git init

作用：将普通文件夹转换成 Git 可管理仓库，新项目仅需执行一次。

3. 将所有文件添加到暂存区

git add .

• \. 表示添加当前目录下全部文件

• 指定单个文件写法：git add 文件名

4. 提交代码到本地仓库

git commit -m "首次提交：完成项目基础框架搭建"

• \-m：填写本次提交注释，必须填写

• 注释规范：简洁明了，写本次改动内容

5. 关联远程 GitHub 仓库

git remote add origin 你的GitHub仓库地址

示例：

git remote add origin https://github.com/xxx/xxx.git

作用：把本地仓库和云端 GitHub 仓库进行绑定。

6. 拉取远程代码（防冲突、必执行）

git pull --rebase origin master

• 作用：同步云端最新代码，防止本地与远程代码不一致导致提交失败

• 如果是全新空仓库，该命令不会拉取任何内容，无影响

7. 推送代码到 GitHub 远程仓库

git push -u origin master

• \-u：绑定默认上游分支，后续提交只需直接输入 git push

四、日常更新代码（最简流程）

第一次上传完成后，后续修改代码只需执行简短三步：

git add .
git commit -m "本次更新：修复bug、优化逻辑"
git push

五、常见报错及解决方案

报错1：fatal: remote origin already exists

原因：已经关联过远程仓库

解决：

git remote remove origin
git remote add origin 新仓库地址

报错2：提交存在冲突

原因：远程代码比本地代码新

解决：

git pull --rebase origin master

手动修改冲突代码后，再次提交推送。

报错3：GitHub 无法使用密码登录

原因：GitHub 已废弃密码登录，需要使用 Token 令牌。

六、极简命令总结（可直接保存背诵）

cd 项目路径
git init
git add .
git commit -m "提交注释"
git remote add origin 仓库地址
git pull --rebase origin master
git push -u origin master

七、总结

命令行提交代码是开发人员必备基础技能，简单、高效、跨平台。熟练掌握以上流程，可完成新项目首次上传、版本迭代、云端备份，适合个人项目、学习代码、开源项目管理。