Git 入门：从初始化仓库到第一次提交与推送的完整流程

对刚开始写代码的人来说，Git 最难的不是命令多，而是不知道一整套流程为什么这样走。本文以一个全新项目为例，把从初始化仓库到第一次推送到远程的过程完整走一遍。

一、先配置身份

在第一次提交之前，先用 git config --global user.name 你的名字 和 git config --global user.email 你的邮箱 告诉 Git 提交者是谁，信息会写入每条提交记录。如果跳过这一步，第一次 commit 往往会报错 Please tell me who you are。配置一次即可，用 git config --list 检查。

二、初始化仓库

进入项目文件夹后执行 git init，会在当前目录生成隐藏的 .git 文件夹，版本记录和分支信息都保存在这里。这一步只需要在项目开始时做一次，不要重复初始化已存在的仓库。

三、第一次提交：add 与 commit

新建文件后用 git status 查看状态，未跟踪说明文件还没被 Git 管理。用 git add . 把改动全部加入暂存区，也可以指定文件名单独添加。确认无误后执行 git commit -m 第一次提交，把暂存区内容保存为一个版本。add 是挑选，commit 是落笔。

四、.gitignore 的作用

依赖目录、编译产物、日志和带密钥的配置文件不该进仓库，把这些规则按每行一条写进根目录的 .gitignore 文件即可。被忽略的文件不会出现在未跟踪列表，也不会被误提交；已提交过的文件则需要先从跟踪中移除。

五、关联远程并首次推送

在托管平台新建空仓库后，执行 git remote add origin 加上远程仓库地址，origin 是默认别名。第一次推送执行 git push -u origin main，其中 -u 让本地 main 分支关联远程 main 分支，之后直接 git push 即可。成功后刷新远程页面就能看到提交的文件。

六、常见报错怎么处理

未配置身份按第一步补上即可。推送被拒提示 non-fast-forward 或 rejected，多半是远程有了本地没有的提交，先执行 git pull --rebase origin main 拉下来整理，再重新 push，不要强行覆盖。权限或网络问题则检查远程地址和账号权限。掌握这条主线，日常 Git 使用就够用了。