企业官网建设流程全解析

first-contributions 项目实战：Git 用户身份配置完全指南（全局、仓库级、命令行三种方式与优先级详解）

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions

导读：本文以 first-contributions 开源教学仓库（README.md）中的 Git 配置指南 为主体，系统讲解初次提交时如何正确设置user.name与user.email，覆盖全局配置、仓库级配置、命令行临时配置三种方式及其优先级规则，并延伸讲解core.editor、commit.template、color.ui等常用配置项。读完本文，你将彻底理解 Git 身份配置的底层机制，能够在 fork→clone→branch→commit→push→Pull Request 的完整贡献流程中顺利通过第一道关卡，不再被 "Please tell me who you are" 报错卡住。

一、问题场景：第一次git commit时的身份提示

在参与 first-contributions 项目的第一次贡献流程中，当你按照 README.md 的指引完成了 fork、clone、创建分支、修改 Contributors.md 并执行git add之后，下一步就是提交更改。然而，很多初学者在第一次执行git commit时，会看到这样一段报错：

$ git commit *** Please tell me who you are. Rode: git config --global user.email "you@example.com" git config --global user.name "Your Name" Para definir a identidade padrão da sua conta. Omita "--global" para definir a identidade apenas nesse repositório

（以上为葡萄牙语版本的提示原文，对应英文原版见 docs/additional-material/git_workflow_scenarios/configuring-git.md。）

为什么会这样？

Git 在创建每一个 commit 时，都必须知道"谁"提交了这次更改。这是 Git 分布式协作设计的核心要求：当多人共同维护一个项目时，必须能够清楚地看到是谁、在什么时间、修改了哪个文件的哪些部分。因此，Git 要求每个提交都必须绑定一个名字（user.name）和一个邮箱（user.email）。

第一次安装 Git 后，系统里并没有这两项配置，所以 Git 会拦截git commit并给出提示。值得注意的是，本仓库中的安装文档同样把身份配置列为安装后的必做步骤——例如 Ubuntu 安装指南 和 Arch 安装指南 在安装完成后都会引导执行git config --global user.name与git config --global user.email，可见身份配置是所有 Git 工作流的第一步。

二、提供身份信息的多种方式

Git 提供了多种方式来向git commit提供邮箱和用户名，下面逐一展开讲解。

1. 全局配置（Global Config）

适用场景：这是最推荐、最常用的方式。全局配置存储在你的用户主目录中，对你系统上所有仓库生效，覆盖绝大多数使用场景。

命令格式：

$ git config --global <variable name> <value>

配置用户信息：

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

执行后，Git 会将这些键值对写入全局配置文件（Linux 下通常为~/.gitconfig）。从该时刻起，你在任何仓库中新建的 commit 都会默认使用这组身份信息，直到在更低优先级的作用域中被覆盖。

2. 仓库级配置（Repository Config）

适用场景：正如其名，这类配置仅作用于当前仓库。例如你在 first-contributions 项目上以个人邮箱贡献开源代码，但同一台机器上还有一个工作相关的项目需要使用公司邮箱提交，就可以在该仓库内单独覆盖身份。

命令格式：与全局配置写法相同，只是省略--global标志：

$ git config <variable name> <value>

配置用户信息：

$ git config user.email "you@alternate.com" $ git config user.name "Your Name"

仓库级配置会写入当前仓库的.git/config文件，只影响这一个仓库，不影响其他项目。

3. 命令行配置（Command-line Config）

适用场景：这类配置只对当前这一条命令生效，是临时性的、最精细的控制方式。例如只想在某一次 commit 中使用特定身份，而不希望写入任何配置文件。

命令格式：所有 Git 命令都可以在动作动词（如commit、push）之前使用-c参数传入临时配置：

$ git -c <variable-1>=<value> -c <variable-2>=<value> <command>

示例（注意-c参数使用key=value的等号形式，且位于commit之前）：

$ git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"

这种方式非常适合一次性操作：配置值只存在于本次命令进程中，命令执行完毕后即被丢弃，不会污染任何配置文件。

4. 三种方式的优先级

这是本文最关键的结论：命令行配置（command-line）> 仓库级配置（repository）> 全局配置（global）。

优先级顺序意味着：如果同一个变量（例如user.email）同时出现在命令行参数和全局配置中，Git 将采用命令行中的值执行本次操作。这一优先级规则保证了三个作用域能够协同工作——全局提供默认值、仓库级针对单个项目覆盖、命令行针对单次操作覆盖，层层递进，互不干扰。

三、超越用户信息：更多常用 Git 配置项

身份配置只是git config的入门。Git 的配置体系非常庞大，这里介绍三个与日常协作（尤其是在向开源项目提交 commit 时）直接相关的常用配置项：

1. core.editor— 指定用于编写提交信息（commit message）等内容的编辑器名称。当执行不带-m参数的git commit时，Git 会打开该编辑器供你撰写提交说明。例如设置为vim、nano或code --wait。

2. commit.template— 指定系统中的一个文件作为初始提交模板。设置后，每次打开提交编辑器时，Git 会预先将模板内容填充进去，帮助团队统一 commit message 的书写格式。

3. color.ui— 布尔值（true/false/auto），用于控制 Git 输出是否使用颜色。开启后，git status、git diff等命令的输出将以彩色高亮显示，极大提升可读性，对初学者判断文件状态（已修改、已暂存、冲突等）非常直观。

设置方式同样统一：

$ git config --global core.editor "code --wait" $ git config --global commit.template ~/.git-commit-template.txt $ git config --global color.ui true

四、在 first-contributions 贡献流程中的应用

结合本仓库的完整贡献流程（README.md）来看，身份配置是整条链路的前提：

1. Fork 本仓库：点击页面顶部的 Fork 按钮，在你的账户下生成副本。
2. Clone 仓库：git clone <你的 fork 地址>将仓库克隆到本地。
3. 创建分支：git switch -c your-new-branch-name（旧版 Git 可用git checkout -b替代，详见 README.md）。
4. 修改文件并提交：编辑 Contributors.md 添加你的名字后，执行git add Contributors.md与git commit -m "Add your-name to Contributors list"——执行这一步之前，正是需要完成本文所述身份配置的时机。
5. 推送与提 PR：git push -u origin your-branch-name，然后在 GitHub 上发起 Pull Request。

可以看到，git commit是流程中无法绕开的环节，而正确的身份配置决定了 commit 能否创建成功、以及最终在贡献历史中显示的作者信息是否正确。此外，仓库还提供了多种语言的教学文档，例如葡萄牙语版本 docs/translations/README.pt_br.md、本文档的 葡萄牙语版本 与 中文版本，以及 Git 工作流场景合集 中的其他进阶技巧（如 修改提交、保持 fork 同步、解决合并冲突），读者可按需查阅。

五、小结与自查清单

掌握 Git 身份配置后，请用以下清单快速自检：

优先级规则始终是命令行 > 仓库级 > 全局。配置完成后，可用git config --list查看当前生效的全部配置，用git config user.name单独查看某项取值，确保提交前的身份信息准确无误。

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions