Git基础：本地仓库搭建与配置全方位指南

文章标题：

Git基础：本地仓库搭建与配置全面解析

文章内容：目录

1、创建目录

2、创建 Git 本地仓库

二、Git 配置指南

1、初始配置

1. 配置用户信息（局部和全局）

2. 注意事项

3. 配置作用域

2、配置管理

1. 查看配置

2. 查看特定配置

3. 修改配置

功能说明

使用场景

更新用户信息

4. 删除配置

移除特定配置：

3、进阶配置（现在只需了解）

多身份管理

常用附加配置

配置文件位置

1、创建目录

在开展相关操作之前，需明确一点，Git 仓库是用于对文件进行版本控制的文件目录。若要对文件实施版本控制，首先得创建一个仓库，而在创建仓库之前，首要任务是创建一个目录：

2、创建 Git 本地仓库

创建 Git 本地仓库的命令为git init，需要留意的是，该命令得在目标文件所在的目录中执行。例如：

当我们执行创建 Git 本地仓库的git init命令后，若出现“Initialized empty Git repository in +路径”的提示，那就表明创建 Git 本地仓库成功了。此时，当前目录下会新增加一个名为.git的隐藏文件：

这个目录是 Git 用于跟踪和管理代码仓库的核心文件，不建议手动对其中的内容进行修改，否则有可能会致使 Git 仓库损坏。该目录涵盖了 Git 仓库的所有元数据信息，有兴趣的读者可以自行去查看了解其内部结构，后续更新的博客会对部分内容进行详细讲解，比如我们能够运用 tree 命令来查看当前目录的树结构：

要是我们没有安装 tree，那就按照提示进行操作先安装好，之后再执行 tree .git 命令来查看：

二、Git 配置指南

1、初始配置

在安装好 Git 之后，首要的任务是配置用户身份信息（设置你的用户名称和电子邮件地址），这对版本控制而言至关重要。Git 会把这些信息嵌入到每一次的提交记录中。

1. 配置用户信息（局部和全局）

执行下述命令来设置非全局（局部，针对当前这个仓库）的用户名和邮箱：

# 非全局，即针对当前仓库
git config user.name "Your Name"
git config user.email "email@example.com"

示例：

我们现在使用 git config -l 命令来查看刚刚配置的局部用户身份信息：

可以看到上面红色方框内是我们刚刚配置的局部用户身份信息！（上面那个配置不用管，是我之前用于远程推送的用户配置，大家刚开始时默认是没有的！）

执行以下命令来设置全局（针对所有仓库）（--global 选项）的用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "email@example.com"

说明：

• 将"Your Name" 替换成你的用户名或者昵称

• 将"email@example.com" 替换成有效的邮箱地址（格式要正确）

• --global 选项意味着是全局配置，适用于该用户的所有 Git 仓库

示例：

我们现在再使用 git config -l 命令来查看刚刚配置的全局用户身份信息：

可以观察到上面的配置信息，能够发现局部和全局的用户身份信息是可以同时存在的！

2. 注意事项

1. 把"Your Name"替换成你常用的昵称或者真实姓名

2. 邮箱地址得使用有效的邮箱格式

3. 建议使用与 GitHub/Gitee 等平台相同的邮箱，以便关联提交（重点）

3. 配置作用域

• 不添加该选项：仅对当前仓库生效（配置存储在 .git/config）

• --system 选项：会影响系统所有用户（需要管理员权限）

• 全局配置（使用 --global 选项）：对当前用户的所有仓库有效（配置存储在 ~/.gitconfig）

• 局部配置（不使用 --global 选项）：仅对当前仓库生效，需在仓库目录内执行

2、配置管理

1. 查看配置

查看所有配置项（包含继承的配置）：

git config -l

2. 查看特定配置

git config user.name
git config user.email

3. 修改配置

功能说明

**--replace-all**选项会替换所有匹配的配置项，以确保没有重复值。相较于直接使用git config --global，它能够更彻底地更新配置。

使用场景

当你的 Git 配置可能出现以下情况时特别有用：

1. 配置文件中存在多个相同的配置项

2. 需要完全覆盖旧配置

3. 不确定当前配置状态时，想确保配置的唯一性

更新用户信息

局部更新：

git config --replace-all user.name "New Name"
git config --replace-all user.email "new@example.com"

全局更新：

git config --global --replace-all user.name "New Name"
git config --global --replace-all user.email "new@example.com"

综上可以得出一个结论，局部和全局的用户配置信息是可以相同的！

4. 删除配置

移除特定配置：

全局移除：

git config --global --unset user.name
git config --global --unset user.email

局部移除：

git config --unset user.name
git config --unset user.email

3、进阶配置（现在只需了解）

多身份管理

如果需要在不同项目中使用不同身份：

1. 进入项目目录

2. 执行无--global选项的配置命令

常用附加配置

# 设置默认文本编辑器
git config --global core.editor "code --wait"

# 启用彩色输出
git config --global color.ui auto

# 设置换行符处理（Windows用户）
git config --global core.autocrlf true

配置文件位置

• 全局配置：~/.gitconfig 或 ~/.config/git/config

• 系统配置：/etc/gitconfig

• 本地配置：.git/config

提示：可通过git config --help查看完整配置文档