新手必学——git日常提交手册
对于编程新手来说,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 pull2. 查看历史提交记录
# 简洁版记录 git log --oneline # 详细版记录 git log3. 撤销暂存(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% 的学习和工作场景。
养成规范提交代码的习惯,不仅能避免代码丢失、版本混乱,还能培养良好的开发习惯,适配后续团队协作、项目开发!
