Git向仓库提交代码三步走详解(add、commit、push)

Git 工作区、暂存区和版本库概念

聊 Git 之前，得先搞明白它最核心的三个概念：工作区、暂存区和版本库。很多人刚接触 Git 时，经常被这几个词绕晕，其实它们之间的关系非常直观。

简单来说，工作区就是你电脑上能看到的那个项目目录，你所有的编辑、增删文件都在这里进行。暂存区（也叫 index），藏在 .git 目录下的 index 文件中，你可以把它想象成一个“中转站”或“预备区”，git add 就是把工作区的改动先放到这个临时区域里等着。版本库则是那个隐藏的 .git 目录，它才是真正的仓库，git commit 就是把暂存区里的内容正式提交到仓库，形成一次版本快照。

下面这张图清晰地展示了这三个区域的关系：

Git向仓库提交代码git commit

理解了上面的概念，再来看提交代码就顺理成章了。git add 负责把工作区的改动“暂存”到暂存区，而 git commit 则是把暂存区里的内容永久保存到版本库，生成一个历史记录点。

不过，Git 在记录每一次提交时，都需要知道是谁做的。所以第一步，必须先配置用户名和邮箱，否则提交时会报错。配置方法很简单：

git config --global user.name 'XXXX'
git config --global user.email XXXXXXXXX@qq.com

账号信息可以通过 Gitee 网站获取，具体路径参考下图：

如果是第一次使用，还需要在项目目录下初始化版本库：

git init

接下来，我们就可以把 test.php 的改动写进暂存区，然后提交。git add . 表示递归添加当前目录下所有文件。而 -m 选项可以直接在命令行中提供提交注释，省去打开编辑器的步骤：

git add .

git commit -m '初始化项目'

提交成功后，会看到类似这样的反馈：

 2 files changed, 2 insertions(+)
 create mode 100644 README
 create mode 100644 test.php

这表示快照已经记录完成。如果此时执行 git status，你会看到：

git status

# On branch master
nothing to commit (working directory clean)

“working directory clean” 意味着自上次提交后，工作目录没有任何改动，一切干净整洁。

要注意的是，如果提交时没有加 -m 选项，Git 会自动打开一个文本编辑器（Linux 下默认是 vim），让你填写提交信息。不习惯 vim 的话，可以提前配置好默认编辑器。

直接提交的小技巧

如果觉得每次都要先 git add 再 git commit 有点繁琐，Git 也提供了捷径——-a 选项，它会把所有已跟踪文件的改动直接提交，跳过暂存环节：

git commit -a

本地分支版本上传到远程git push

本地仓库开发完成后，终归要推送到远程仓库（比如 Gitee）进行协作或备份。首先，需要将本地仓库与远程仓库建立连接。回到 Gitee 仓库页面，复制 HTTPS 链接：

然后执行连接命令：

git remote add origin 刚才复制的https链接 

如果远程仓库已经有内容，推送前最好先拉取最新代码，避免冲突：

git pull --rebase origin master

最后，将本地代码推送到远程仓库：

git push -u origin master

如果 Gitee 弹出登录窗口，正常登录即可。完成后回到 Gitee 仓库页面刷新，就能看到代码已经成功上传了。

有时候，你明明修改了文件，却发现它怎么都不被推送上去。这时候，记得检查一下项目根目录下的 .gitignore 文件，很可能该文件已经被列入了忽略规则。

如何强制删除本地的所有更改？

如果你希望彻底清理本地所有未提交的更改、暂存的内容，甚至本地分支上的提交，让本地仓库完全同步远程分支的最新状态，可以按以下步骤操作：

• 先备份你真正重要的更改，因为下面的操作会直接丢弃它们。
• 如果只是想暂时保存更改，可以用 git stash 暂存起来；如果确实想丢弃，直接使用 git reset --hard。

git stash sa ve "My stash message"  # 如果你想保存更改，后续可以恢复

git reset --hard                   # 直接丢弃所有未提交的更改

总结

从工作区到暂存区，再到版本库，最后推送到远程仓库，Git 的这套流程构成了日常开发中最核心的操作闭环。理解它，你就掌握了 Git 的半壁江山。