新手必学——git日常提交手册

原创已于 2026-06-07 13:59:04 修改 · 427 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#git

于 2026-05-22 20:57:15 首次发布

对于编程新手来说，Git 是必备的开发工具，也是日常写代码、保存代码、同步代码的核心技能。很多新手写代码翻车、代码丢失、版本混乱、多人协作冲突，本质都是不会正确使用 Git 提交代码。

这篇手册专为新手打造，不讲复杂原理，只讲日常开发 100% 会用到的 Git 操作，从零学会代码提交、保存、回退、推送，看完直接上手工作、学习项目！

一、Git 核心认知（新手必记）

Git 简单来说就是代码版本管理工具，核心作用：记录代码每一次修改、随时还原旧版本、多人协作互不冲突、本地云端同步代码。

Git 工作分为四个区域，新手搞懂这个就成功一半：

工作区：你电脑本地写代码的文件夹（看得见、直接修改代码的地方）
暂存区：临时存放修改的地方（相当于购物车，存放要提交的代码）
本地仓库：本地永久保存代码版本的地方（相当于存档点）
远程仓库：GitHub / Gitee / 公司 GitLab 云端仓库（备份、同步、协作）

完整流程：工作区修改 → 暂存区添加 → 本地仓库提交 → 远程仓库推送

二、首次使用 Git 必做配置（仅一次）

第一次安装 Git 后，必须配置用户名和邮箱，否则无法提交代码，全局配置一次永久生效。

打开 Git Bash，输入以下两条命令（替换成自己的用户名和邮箱）：

# 配置用户名（自定义，建议用真实姓名/昵称）
git config --global user.name "你的用户名"

# 配置邮箱（GitHub/Gitee 注册邮箱）
git config --global user.email "你的邮箱"

查看配置是否成功：

git config --global --list

三、新手日常核心提交流程（万能模板）

日常写代码、改代码、保存代码，永远固定这 4 步，适配所有项目！

1. 查看代码修改状态

git status

作用：查看哪些文件被修改、新增、删除，红色是未暂存，绿色是已暂存。新手每次提交前必看！

2. 添加代码到暂存区（加入购物车）

# 添加单个文件
git add 文件名

# 添加所有修改、新增、删除的文件（新手最常用）
git add .

注意：git add . 会添加所有改动文件，日常开发首选，简单不踩坑。

3. 提交到本地仓库（正式存档）

git commit -m "本次修改说明"

示例：

git commit -m "完成日志类基础功能，修复拼接bug"

规范要求：提交说明简洁清晰，写清楚做了什么修改，方便后续回溯版本。

4. 推送到远程仓库（同步到云端）

git push

作用：把本地存档的代码，同步到 GitHub/Gitee/公司远程仓库，备份代码、方便协作。

四、新项目初始化提交步骤（第一次提交专用）

新建本地项目，关联远程仓库，首次提交代码流程：

# 1. 初始化本地 git 仓库
git init

# 2. 添加所有文件到暂存区
git add .

# 3. 本地提交
git commit -m "项目初始化，提交基础代码"

# 4. 关联远程仓库（替换成自己的远程仓库地址）
git remote add origin 远程仓库地址

# 5. 首次推送代码到远程
git push -u origin master

备注：首次推送用 git push -u origin master，后续直接输入 git push 即可。

五、日常高频必备 Git 命令（新手收藏）

1. 拉取远程最新代码（多人协作必用）

多人开发时，先拉取别人的最新代码，再写新代码，避免冲突：

git pull

2. 查看历史提交记录

# 简洁版记录
git log --oneline

# 详细版记录
git log

3. 撤销暂存（add 错了怎么办）

git reset HEAD .

作用：把已经 add 的代码，撤回回到工作区，不删除代码，只取消暂存。

4. 撤销本地提交（commit 写错了怎么办）

git reset --soft HEAD~1

作用：撤销上一次本地提交，代码保留，可重新修改后提交。

5. 放弃本地所有修改（代码写崩了重置）

git checkout .

作用：丢弃工作区所有修改，还原到上一次提交的版本（谨慎使用！）

六、新手最常踩的坑+解决方案

坑1：推送代码报错，提示冲突

原因：远程仓库有最新代码，本地代码不是最新版本。

解决：先拉取最新代码，再重新提交推送：

git pull
git add .
git commit -m "解决代码冲突，同步远程版本"
git push

坑2：重复提交无用文件

问题：编译产物、日志文件、IDE 配置文件被提交，导致仓库臃肿。

解决：项目根目录新建 .gitignore 文件，写入需要忽略的文件：

# 忽略编译产物
bin/
build/

# 忽略日志文件
*.log

# 忽略 IDE 配置
.vscode/
.idea/

坑3：提交说明乱写、空提交

新手大忌：git commit -m "更新代码"“随便改改”“修复bug”

规范写法：精准描述修改内容，例如：

修复日志拼接空指针bug
新增时间戳工具类，优化日志格式
调整项目目录结构，拆分模块文件

七、新手日常提交标准流程（最终总结）

日常开发严格遵守这个闭环，零报错、零混乱：

写代码、改代码，完成功能/修复bug
git status 查看修改文件
git add . 暂存所有改动
git commit -m "清晰的修改说明" 本地存档
git pull 拉取最新代码（多人协作）
git push 同步到云端

八、写在最后

Git 不是高深工具，是开发必备基本功。新手不用死记所有命令，先掌握本文的日常提交、撤回、拉取、推送核心操作，足以应对 99% 的学习和工作场景。

养成规范提交代码的习惯，不仅能避免代码丢失、版本混乱，还能培养良好的开发习惯，适配后续团队协作、项目开发！