一步步教你完成Git用户名和密码配置 – wiki基地

一步步教你完成 Git 用户名和密码配置（超详细教程）

Git 是目前世界上最流行的分布式版本控制系统，无论是个人开发者还是大型团队，都离不开 Git 来管理代码。在使用 Git 之前，配置用户名和密码是至关重要的一步，它决定了你在 Git 仓库中的身份标识，以及你是否有权限进行代码的提交、拉取等操作。

本文将深入探讨 Git 用户名和密码配置的方方面面，从基础概念到高级技巧，从本地配置到全局配置，从命令行操作到图形界面工具的使用，都将一一涵盖。无论你是 Git 新手还是有一定经验的开发者，相信都能从中获益。

1. 为什么要配置 Git 用户名和密码？

在 Git 的世界里，每一次提交（commit）都会记录下是谁进行了这次更改。这个“谁”就是通过用户名来标识的。而密码则是为了验证你的身份，确保只有你本人才能对仓库进行修改。

• 身份标识： 当你向远程仓库推送代码时，Git 会使用你的用户名来标记这次提交的作者。这对于团队协作非常重要，可以清晰地追踪代码的变更历史，方便问题的定位和责任的划分。
• 权限控制： 密码是保护你代码仓库的钥匙。如果没有正确的密码，其他人将无法修改你的仓库，从而保证了代码的安全性。
• 版本追溯： Git 的强大之处在于它可以回溯到任何一个历史版本。而用户名和密码的配置，使得我们可以清楚地知道每一个版本是由谁在什么时间创建或修改的。

2. Git 用户名和密码的配置方式

Git 提供了多种配置用户名和密码的方式，你可以根据自己的需求和习惯选择最适合的一种。

2.1. 命令行配置

命令行是 Git 最基本的操作方式，也是最灵活的方式。通过命令行，你可以进行各种 Git 配置，包括用户名和密码的设置。

2.1.1. 全局配置

全局配置会影响你计算机上的所有 Git 仓库。如果你希望所有的仓库都使用相同的用户名和密码，那么全局配置是最方便的选择。

• 设置全局用户名：

  bash
git config --global user.name "Your Name"

  将 “Your Name” 替换为你想要设置的用户名。
  * 设置全局用户邮箱：

  bash
git config --global user.email "[email protected]"

  将 “[email protected]” 替换为你想要设置的邮箱地址。这个邮箱地址通常会与你的 Git 托管平台（如 GitHub、GitLab、Bitbucket 等）账号关联。
  * 查看全局配置：
  bash
git config --global --list
  或者直接编辑 ~/.gitconfig文件
  * 全局配置的密码：
  全局配置密码通常不是直接在命令行中以明文形式设置的，而是通过凭据管理器（Credential Manager）来实现。这样做是为了提高安全性，避免密码泄露。不同的操作系统有不同的凭据管理器：

  • Windows: Git Credential Manager for Windows
  • macOS: Keychain Access
  • Linux: 通常使用 libsecret 或类似的工具

  当你第一次向远程仓库推送代码时，Git 会提示你输入用户名和密码。输入后，凭据管理器会将这些信息安全地存储起来，以后就不需要再次输入了。

2.1.2. 本地配置（仓库级配置）

本地配置只对当前 Git 仓库有效。如果你希望不同的仓库使用不同的用户名和密码，那么可以使用本地配置。

• 进入仓库目录： 首先，使用 cd 命令进入你的 Git 仓库所在的目录。

• 设置本地用户名：

  bash
git config user.name "Your Name"
  * 设置本地用户邮箱：

  bash
git config user.email "[email protected]"
  * 查看本地配置:
  bash
git config --list
  或者查看当前仓库文件夹下的.git/config文件

• 本地配置的密码： 与全局配置类似，本地配置的密码通常也是通过凭据管理器来管理的。

2.1.3. 系统级配置(不推荐)

这种配置会应用到所有用户。

• 设置系统级用户名和邮箱
  bash
git config --system user.name "Your Name"
git config --system user.email "[email protected]"
• 查看系统级配置:
  bash
git config --system --list
  或者查看/etc/gitconfig

2.1.4. 优先级

如果同时存在全局配置、本地配置和系统级配置，那么它们的优先级是：

1. 本地配置（仓库级配置）
2. 全局配置
3. 系统级配置

也就是说，本地配置会覆盖全局配置，全局配置会覆盖系统级配置。

2.2. 图形界面工具配置

除了命令行，许多 Git 图形界面工具（如 GitHub Desktop、SourceTree、GitKraken 等）也提供了配置用户名和密码的功能。这些工具通常具有更友好的用户界面，操作起来更直观。

2.2.1. GitHub Desktop

1. 打开 GitHub Desktop。
2. 点击 “File” -> “Options” (Windows) 或 “GitHub Desktop” -> “Preferences” (macOS)。
3. 在 “Git” 选项卡中，你可以看到 “Name” 和 “Email” 字段。
4. 输入你的用户名和邮箱地址，然后点击 “Save”。

GitHub Desktop 会自动使用凭据管理器来存储你的密码。

2.2.2. SourceTree

1. 打开 SourceTree。
2. 点击 “Tools” -> “Options” (Windows) 或 “SourceTree” -> “Preferences” (macOS)。
3. 在 “General” 选项卡中，你可以找到 “Default user information” 部分。
4. 输入你的用户名和邮箱地址，然后点击 “OK”。

SourceTree 同样会使用凭据管理器来存储密码。

2.2.3. GitKraken

1. 打开 GitKraken。
2. 点击左上角的头像图标，然后选择 “Preferences”。
3. 在 “General” 选项卡中，你可以找到 “User Profile” 部分。
4. 输入你的用户名和邮箱地址，然后点击 “Save Changes”。

GitKraken 也会使用凭据管理器来存储密码。

2.3 使用SSH密钥

除了用户名和密码，SSH 密钥是另一种常用的身份验证方式。SSH 密钥由一对文件组成：私钥（你保存在本地）和公钥（你添加到 Git 托管平台）。

2.3.1. 生成 SSH 密钥

1. 打开终端（Terminal）或 Git Bash。

2. 输入以下命令：

   bash
ssh-keygen -t rsa -b 4096 -C "[email protected]"

   • -t rsa：指定密钥类型为 RSA。
   • -b 4096：指定密钥长度为 4096 位（更安全）。
   • -C "[email protected]"：添加注释，通常是你的邮箱地址。

3. 系统会提示你输入保存密钥的文件名（默认为 ~/.ssh/id_rsa），直接按回车键即可。

4. 系统会提示你输入密码（passphrase），这是可选的，但建议设置一个强密码来保护你的私钥。
5. 再次输入密码进行确认。

生成成功后，你会在 ~/.ssh 目录下看到两个文件：id_rsa（私钥）和 id_rsa.pub（公钥）。

2.3.2. 添加公钥到 Git 托管平台

1. 打开 id_rsa.pub 文件，复制其中的全部内容。
2. 登录到你的 Git 托管平台（如 GitHub、GitLab、Bitbucket 等）。
3. 找到 SSH 密钥设置页面（通常在 “Settings” 或 “Profile” 中）。
4. 添加一个新的 SSH 密钥，将你复制的公钥内容粘贴到 “Key” 字段中。
5. 给这个密钥起一个名字（例如 “My Home Computer”），然后保存。

2.3.3. 测试 SSH 连接

在终端中输入以下命令：

bash
ssh -T [email protected]

如果看到类似 “Hi username! You’ve successfully authenticated…” 的消息，说明 SSH 连接成功。

使用 SSH 密钥的好处是：

• 更安全： 私钥保存在本地，不会通过网络传输，更难被窃取。
• 更方便： 不需要每次都输入密码，只需要输入一次密码（如果你设置了 passphrase）。

3. 常见问题及解决方案

3.1. 忘记密码

如果你忘记了 Git 托管平台的密码，可以通过以下方式找回：

• 重置密码： 大多数 Git 托管平台都提供了密码重置功能，你可以通过邮箱或手机号来重置密码。
• 使用 SSH 密钥： 如果你之前已经配置了 SSH 密钥，可以直接使用 SSH 密钥进行身份验证，无需输入密码。

3.2. 修改用户名或邮箱

如果你需要修改用户名或邮箱，可以重新运行 git config 命令进行设置。

3.3. 凭据管理器问题

如果你的凭据管理器出现问题，导致 Git 无法记住你的密码，可以尝试以下方法：

• 清除凭据： 在凭据管理器中找到与 Git 相关的条目，将其删除，然后重新输入用户名和密码。
• 更新 Git： 确保你的 Git 版本是最新的，有时旧版本的 Git 可能会与凭据管理器不兼容。
• 更换凭据管理器： 如果你使用的是 Windows，可以尝试使用 Git Credential Manager for Windows 的不同版本。

3.4. 403 Forbidden 错误

如果你在推送代码时遇到 403 Forbidden 错误，通常表示你没有权限访问该仓库。可能的原因包括：

• 用户名或密码错误： 仔细检查你的用户名和密码是否正确。
• 没有仓库访问权限： 联系仓库管理员，确认你是否被授予了访问权限。
• SSH 密钥问题： 如果你使用的是 SSH 密钥，确保你的公钥已正确添加到 Git 托管平台。

3.5. 凭据缓存时间

默认情况下，Git 会将你的凭据缓存一段时间（通常是 15 分钟）。你可以通过以下命令修改缓存时间：

bash
git config --global credential.helper 'cache --timeout=3600'

将 3600 替换为你想要的缓存时间（单位：秒）。

4. 总结

Git 用户名和密码配置是 Git 使用的基础，也是保证代码安全和协作效率的关键。本文详细介绍了各种配置方式，包括命令行配置、图形界面工具配置以及 SSH 密钥的使用。希望通过本文，你能够熟练掌握 Git 用户名和密码的配置，并在你的开发工作中更加得心应手。

记住，无论你选择哪种配置方式，都要确保你的密码足够安全，并妥善保管好你的私钥（如果你使用 SSH 密钥）。只有这样，才能保护你的代码免受未经授权的访问。