git使用指南

Git 就像代码的“时间机器”，它能帮你记录每一次修改，让你随时可以回到过去的任何一个版本。

这是一份为你定制的 Git 核心操作速成指南，涵盖了从入门到协作最常用的命令。

🚀 第一阶段：初始化与首次提交

假设你已经有了一个项目文件夹。

1. 初始化仓库

在终端进入你的项目目录，输入：

git init

• 作用：在当前目录下创建一个隐藏的 .git 文件夹，这是 Git 的“大脑”，用来存储所有版本历史。

2. 添加文件（暂存）

Git 的工作流程是：工作区 -> 暂存区 -> 版本库。你需要先把文件放入“暂存区”。

git add .

• 作用：将所有修改过的、未被忽略的文件添加到暂存区。
• 提示：你也可以只添加特定文件，如 git add main.py。

3. 提交更改（保存快照）

git commit -m "feat: 初始化项目结构"

• 作用：将暂存区的内容正式保存到版本库中，生成一个永久快照。
• 提示：-m 后面跟的是提交信息，建议写得清晰明确。

---

🔄 第二阶段：日常开发循环

这是你每天写代码时最常用的一套连招。

1. 查看状态

在做任何操作前，先看看现在是什么情况：

git status

• 作用：告诉你哪些文件被修改了、哪些在暂存区、哪些还没被追踪。

2. 提交新代码

当你修复了一个 Bug 或写完一个功能：

git add .
git commit -m "fix: 修复登录逻辑的错误"

3. 查看历史记录

想看之前都干了什么：

git log

• 作用：显示提交历史、作者和时间。
• 技巧：按 q 键退出查看模式。

---

☁️ 第三阶段：远程协作（GitHub/GitLab）

如果你的代码要传到云端，或者和别人合作。

1. 关联远程仓库

git remote add origin <你的仓库地址>

• 作用：给你的远程仓库起个别名（通常叫 origin），方便提交到远程分支，不用每次都输入一长串网址。
• git remote
  • 意思：远程仓库管理。
  • 作用：告诉 Git，“我要操作的是远程服务器上的那个仓库，而不是我电脑里的这个”。
• add
  • 意思：添加。
  • 作用：这是一个“注册”动作。你本地虽然有代码，但 Git 还不知道你要把它推送到哪里去。
• origin
  • 意思：起源/源头（这里指代远程仓库的别名）。
  • 作用：这是一个简称。
  • 为什么要用它？ 因为每次推送代码时，你不可能每次都输入一长串网址（比如 https://github.com/user/project.git）。Git 允许你给这个长网址起个代号，大家都习惯把这个代号叫做 origin。
  • 注：虽然通常叫 origin，但你其实也可以叫它 server、github 或者其他名字，只要后面保持一致就行。
• <你的仓库地址>
  • 意思：远程仓库的 URL。
  • 例子：比如 https://github.com/yourname/yourproject.git 或者 git@github.com:yourname/yourproject.git。

2. 推送代码

git push -u origin main

• 作用：将本地的 main 分支推送到远程。
• 注意：-u 只需要在第一次推送时加，以后直接输 git push 即可。

3. 拉取代码

在开始工作前，先同步别人的修改：

git pull origin main

• 作用：下载远程最新代码并自动合并到你的本地。

---

🛡️ 第四阶段：分支管理（进阶）

不要直接在主分支上乱改，用分支来隔离你的开发工作。

1. 创建并切换分支

git checkout -b feature-login

• 作用：创建一个叫 feature-login 的新分支并跳过去。

2. 合并分支

当你在新分支开发完，想合并回主分支：

git checkout main        # 先切回主分支
git merge feature-login  # 把新分支的内容合并进来

---

📌 Git 核心概念速查表

命令	作用	常用参数
git add	将文件从工作区放入暂存区	. (所有文件)
git commit	将暂存区文件保存到仓库	-m "消息"
git status	查看当前文件状态	(无)
git push	推送到远程服务器	-u origin main
git pull	从远程拉取代码	origin main
git log	查看历史版本	--oneline (简洁模式)

💡 给新手的建议

1. 勤提交：每完成一个小功能或修复一个 Bug 就提交一次，不要攒了一周再提交。
2. 写好注释：git commit -m "update" 是不好的习惯，写成 git commit -m "feat: 增加用户登录功能" 会让未来的你感激涕零。