初次运行 Git 前的配置

封面图 • 2025-11-22 • git

在初次运行 Git 之前，进行一些基本的配置是非常重要的。这些配置可以帮助你更好地使用 Git，并确保提交记录中包含正确的信息。

以下是常见的 Git 初次配置步骤：

---

## ✅ 1. 设置全局用户名（用于提交记录）

```bash
git config --global user.name "YourName"
```

例如：

```bash
git config --global user.name "John Doe"
```

---

## ✅ 2. 设置全局邮箱（用于提交记录）

```bash
git config --global user.email "your.email@example.com"
```

例如：

```bash
git config --global user.email "john.doe@example.com"
```

---

## ✅ 3. 查看当前配置（可选）

你可以通过以下命令查看当前的 Git 配置：

```bash
git config --list
```

或者只查看用户信息：

```bash
git config user.name
git config user.email
```

---

## ✅ 4. 设置默认编辑器（可选）

如果你希望 Git 使用特定的文本编辑器（如 VS Code、Vim 等），可以设置默认编辑器：

```bash
git config --global core.editor "code --wait"   # 对于 VS Code
git config --global core.editor "vim"          # 对于 Vim
```

---

## ✅ 5. 设置别名（可选）

Git 允许你为常用命令设置别名，提高效率。例如：

```bash
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
```

这样你可以用 `git co` 替代 `git checkout`，用 `git ci` 替代 `git commit`。

---

## ✅ 6. 设置默认分支名称（可选）

如果你使用的是较新的 Git 版本（2.28+），可以设置默认分支名称（比如 `main` 而不是 `master`）：

```bash
git config --global init.defaultBranch main
```

---

## ✅ 7. 设置自动换行符处理（可选）

如果你在 Windows 上使用 Git，可以设置自动转换换行符：

```bash
git config --global core.autocrlf true
```

如果你在 Linux 或 macOS 上使用，通常不需要这个设置。

---

## 📌 总结

| 命令 | 说明 |
|------|------|
| `git config --global user.name "YourName"` | 设置全局用户名 |
| `git config --global user.email "email@example.com"` | 设置全局邮箱 |
| `git config --list` | 查看所有配置 |
| `git config --global core.editor "editor"` | 设置默认编辑器 |
| `git config --global alias.co checkout` | 设置别名 |
| `git config --global init.defaultBranch main` | 设置默认分支 |

---

如果你是刚开始使用 Git，建议先完成以上配置，这将使你的 Git 使用体验更加顺畅。

需要我帮你检查或配置具体的项目吗？