first-contributions 实战Git 用户身份与配置作用域完全指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions首次执行git commit时Git 会以 Please tell me who you are 报错并拒绝提交——这正是本指南要解决的核心问题。作为面向开源初学者的 first-contributions 项目配套进阶材料本文将以 docs/additional-material/translations/Slovenian/configuring-git.sl.md 为骨架系统讲解 Git 的用户身份配置user.name/user.email、全局 / 仓库 / 命令行三种配置作用域及其优先级并延伸到core.editor、commit.template、color.ui、凭据缓存等实用配置项。读完本文你将能独立完成 Git 环境初始化并准确判断任意配置项在不同作用域下的生效结果。为什么 Git 必须知道你是谁Git 是分布式版本控制系统每次commit都会把提交者的姓名与邮箱永久写入提交对象中。协作场景下团队需要依据提交记录准确追溯谁在什么时间修改了哪个文件——这正是 first-contributions 这类开源项目评审 Pull Request 时的重要依据。因此当 Git 检测不到用户身份时会拒绝执行提交并给出如下提示$ git commit *** Please tell me who you are. Run git config --global user.email youexample.com git config --global user.name Your Name to set your accounts default identity. Omit --global to set the identity only in this repository.提示信息本身已经点明了本文的两条主线一是用--global设置全局默认身份二是省略--global只为当前仓库设置身份。下面逐一展开。三种配置作用域与对应命令Git 配置系统按作用域从大到小分为三个层级写入的位置与生效范围各不相同。你可以通过三种方式告诉git commit你的姓名与邮箱官方推荐优先使用全局配置。全局配置Global Config全局配置存储在用户主目录下的~/.gitconfig文件中对当前系统用户操作的所有仓库全局生效。对绝大多数个人开发场景而言这是最推荐的配置方式——只需配置一次所有仓库共享同一身份。$ git config --global variable name value以配置用户身份为例$ git config --global user.email youexample.com $ git config --global user.name Your Name注意这里的邮箱建议使用你在 GitHub 等托管平台绑定的邮箱或 GitHub 提供的usernameusers.noreply.github.com隐私邮箱这样提交才能正确关联到你的账号并在 first-contributions 的 Contributors.md 贡献者列表中留下可追溯的记录。仓库级配置Repository Config仓库级配置写入当前仓库目录下的.git/config文件中只对当前这一个仓库生效。典型场景是你在同一个机器上同时维护个人项目与公司项目公司项目需要以公司邮箱提交这时就应为该仓库单独覆盖身份信息而不影响全局配置。写法与全局配置完全相同只需省略--global标志$ git config variable name value例如为某个特定仓库设置备用邮箱$ git config user.email youalternate.com $ git config user.name Your Name# 验证当前仓库实际生效的身份 $ git config user.name $ git config user.email命令行级配置Command-line Config命令行配置是最临时的一种它只对当前这一条命令生效不写入任何配置文件。所有 Git 子命令都支持在动作动词之前用-c参数注入临时配置项适合一次性提交、脚本化操作或 CI 流水线中临时指定作者信息。语法为$ git -c variable-1value -c variable-2value command在提交场景中的完整示例$ git -c user.nameYour Name -c user.emailyouexample.com commit -m Your commit message# 逐项查看生效值不含配置文件写入 $ git -c user.nameTmp User -c user.emailtmpexample.com var GIT_AUTHOR_IDENTgit var GIT_AUTHOR_IDENT会按优先级合成最终作者标识是验证命令行配置是否生效的可靠手段。优先级规则command-line repository global三种作用域发生冲突时生效顺序为命令行配置 仓库配置 全局配置。也就是说如果同一个变量同时在全局和命令行中设置实际操作会采用命令行中的值如果同时在全局与仓库中设置则采用仓库中的值。这为全局兜底、局部覆盖的配置策略提供了明确依据。此外Git 实际还存在第四个层级——系统级配置通常位于/etc/gitconfig其优先级低于全局配置。若需查看当前所有生效配置及其来源可使用# 列出全部生效配置 $ git config --list # 同时显示每条配置来自哪个文件推荐用于排查 $ git config --list --show-origin # 查看某一项配置的具体来源文件 $ git config --show-origin user.name输出中会同时包含~/.gitconfig全局、.git/config仓库级与/etc/gitconfig系统级的条目配合--show-origin可以一目了然地定位冲突项来自何处。超越用户身份更多常用配置项配置系统并不局限于用户身份。原文档特别列举了三个高频实用配置并说明为便于理解做了一些简化此处结合 Git 的实际行为展开core.editor—— 指定用于编写提交说明以及交互式变基、合并信息等的文本编辑器。若不设置Git 会依次回退到GIT_EDITOR环境变量、VISUAL、EDITOR最后使用内置默认编辑器。示例$ git config --global core.editor code --wait $ git config --global core.editor vimcommit.template—— 指定一个文件路径作为每次提交时的初始提交说明模板适合团队统一提交格式例如要求写明修改类型与关联 Issue。示例$ git config --global commit.template ~/.git-commit-template.txtcolor.ui—— 控制 Git 输出是否使用颜色。接受布尔值true/false或always/auto。auto表示仅在输出到终端时着色重定向到文件时自动禁用颜色是最稳妥的选择$ git config --global color.ui auto与配置紧密相关的还有凭据存储。首次通过 HTTPS 推送到远程仓库时Git 会反复提示输入用户名与密码。仓库配套文档 storing-credentials.md 详细介绍了credential.helper的用法其本身也是git config的典型应用# 全局缓存凭据明文写入磁盘注意遵守所在机构的安全策略 $ git config --global credential.helper cache # 仅当前仓库缓存 $ git config credential.helper cache # 指定缓存时长秒默认 900 秒 $ git config credential.helper cache --timeouttimeout注意cache辅助器将凭据明文存放在内存/磁盘中请务必遵循你所在工作单位或学校的安全策略更安全的替代方案是使用系统凭据管理器或 SSH 密钥认证参见 README.md 中Authentication Error一节关于git remote set-url origin gitgithub.com:...的说明。在 first-contributions 中的实际应用本仓库的完整贡献流程是 fork → clone → 新建分支 → 修改 Contributors.md → commit → push → Pull Request斯洛文尼亚语版流程见 README.sl.md。其中git commit -m Add your-name to Contributors list这一环正是配置知识的最佳练兵场若从未配置身份首次提交会触发文章开头所示的报错——按提示执行两条git config --global命令即可解决若你同时用多个身份参与开源则可以为克隆到本地的仓库执行仓库级配置避免污染全局身份提交后可用git log用法详见 check-commit-log.md核对提交记录中的 Author 字段是否与预期一致。该进阶文档在项目中的定位见配套索引 additional-material.mdConfiguring git——Use this to better control your git configurations斯洛文尼亚语版的全部进阶材料统一收录于 additional-material.sl.md英文原版见 configuring-git.md。小结Git 以user.name与user.email标记每次提交的作者缺失时提交会被拒绝配置存在三个作用域优先级为命令行 仓库 全局写入位置分别是命令参数、.git/config与~/.gitconfiggit config --list --show-origin是排查配置冲突的利器core.editor、commit.template、color.ui、credential.helper等配置项与用户身份同属一套配置体系掌握了git config的语法即可一通百通。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考