🛠 Git 新手完全指南（Windows / Linux / Mac 通用）#

1️⃣ Git 基本概念#

在动手之前，你需要知道 Git 是干嘛的：

• Git：版本控制工具，帮你保存、回退和同步代码。
• 仓库（Repository）：存放代码的地方，可以在本地，也可以在 GitHub 等平台。
• 分支（Branch）：代码的不同版本，main 或 master 是主分支。
• 提交（Commit）：保存代码的快照。
• 远程（Remote）：比如 GitHub、GitLab 等代码托管平台。

2️⃣ 首次安装与配置#

1
git config --global user.name "你的Git用户名"
2
git config --global user.email "你的Git邮箱"

3️⃣ 常用 Git 命令速查表#

4️⃣ 本地项目推送到 GitHub（从 0 开始）#

假设你已经在 GitHub 创建了一个空仓库。

1
# 进入你的项目目录
2
cd 你的项目文件夹路径
3

4
# 初始化本地仓库
5
git init
6

7
# 添加所有文件到暂存区
8
git add .
9

10
# 提交到本地仓库
11
git commit -m "first commit"
12

13
# 默认分支改成 main（GitHub 默认）
14
git branch -M main
15

16
# 添加远程仓库（替换成你自己的）
17
git remote add origin https://github.com/你的用户名/你的仓库名.git
18

19
# 推送到 GitHub
20
git push -u origin main

5️⃣ 从 GitHub 拉取项目到本地#

如果别人给了你一个仓库地址：

1
git clone https://github.com/用户名/仓库名.git

会在当前文件夹生成一个同名目录，里面就是完整项目。

6️⃣ 日常开发流程（单人版）#

1
# 1. 拉取远程最新代码
2
git pull origin main
3

4
# 2. 修改文件...
5

6
# 3. 查看修改状态
7
git status
8

9
# 4. 添加修改到暂存区
10
git add .
11

12
# 5. 提交修改
13
git commit -m "描述你的改动"
14

15
# 6. 推送到远程
16
git push origin main

7️⃣ 撤销 & 回退#

• 撤销未暂存的修改：

  1
  git checkout -- 文件名
  

• 取消暂存区的文件：

  1
  git reset 文件名
  

• 回退到上一个提交：

  1
  git reset --hard HEAD^
  

8️⃣ 进阶技巧#

• 查看分支：

  1
  git branch
  

• 删除分支：

  1
  git branch -d 分支名
  

• 合并分支：

  1
  git merge 分支名
  

• 拉取时自动合并：

  1
  git pull --rebase
  

9️⃣ 遇到常见错误#

• error: src refspec main does not match any → 本地没有 main 分支，先用 git branch -M main。
• failed to push some refs → 本地和远程不一致，先 git pull origin main --rebase 再推送。

🔟 学习建议#

1. 先把 初始化 → 提交 → 推送 这三步练熟。
2. 养成每次改动后 git status 的习惯。
3. 每次推送前先 git pull，避免冲突。
4. 冲突不要怕，Git 会提示你怎么改。