常用Git用法记录

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

1️⃣ Git 基本概念

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

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

2️⃣ 首次安装与配置

安装

Windows: 下载 Git → 一路下一步安装。

Linux:

sudo apt install git    # Debian/Ubuntu
sudo yum install git    # CentOS

Mac:
```
brew install git
```

配置用户名和邮箱（只做一次）

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

⚠️ 这要和你 GitHub 注册的邮箱一致，才能关联你的提交记录。

3️⃣ 常用 Git 命令速查表

操作	命令
初始化本地仓库	`git init`
查看状态	`git status`
添加文件到暂存区	`git add 文件名` / `git add .`（全部）
提交到本地仓库	`git commit -m "提交说明"`
查看提交历史	`git log`
新建标签	`git tag -a "标签名字" -m "标签描述"`
新建分支	`git branch 分支名`
切换分支	`git checkout 分支名`
合并分支	`git merge 分支名`
添加远程仓库	`git remote add origin 仓库地址`
推送到远程	`git push -u origin 分支名`
拉取远程代码	`git pull origin 分支名`
克隆远程仓库	`git clone 仓库地址`

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

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

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

# 初始化本地仓库
git init

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

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

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

# 添加远程仓库（替换成你自己的）
git remote add origin https://github.com/kobayashirei/blog.git

# 推送到 GitHub
git push -u origin main

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

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

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

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

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

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

# 2. 修改文件...

# 3. 查看修改状态
git status

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

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

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

7️⃣ 撤销 & 回退

撤销未暂存的修改：
```
git checkout -- 文件名
```
取消暂存区的文件：
```
git reset 文件名
```
回退到上一个提交：
```
git reset --hard HEAD^
```

8️⃣ 进阶技巧

查看分支：
```
git branch
```
删除分支：
```
git branch -d 分支名
```
合并分支：
```
git merge 分支名
```
拉取时自动合并：
```
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 再推送。

🔟 学习建议

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