高效配置 Git 与 GitLab：从安装到安全认证全流程

前言

GitLab 作为一款强大的代码托管和协作平台，被广泛用于版本控制和团队项目管理。本文详细介绍从 Git 安装到完成 GitLab 账户安全认证的全流程，帮助开发者快速搭建高效的开发环境。

一、安装 Git

本文使用 Homebrew 安装 Git。

1. 打开终端（Terminal），如果没安装 Homebrew，先使用以下命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装git：

   brew install git

3. 检查版本：

   git --version

如果显示git版本则表明git安装成功。

二、配置 Git 的用户信息（全局）

配置 Git 的用户信息（用户名和邮箱）是为了在版本历史中准确标识每一次提交的作者。Git 作为分布式版本控制系统，不仅记录代码改动本身，还会把这些改动与对应的用户名和邮箱绑定起来，这样在查看变更记录、追踪问题或进行代码审查时，就能清楚知道每个修改是谁完成的。

1. 终端中执行（使用自己的名字和邮箱）

git config --global user.name "你的名字或昵称"
git config --global user.email "你的邮箱"

ps：注册GitLab时也需要使用这个邮箱

2. 查看是否设置成功：

git config --global --list

如果设置成功，会显示

user.name=...
user.email=...

三、生成 SSH 密钥

在本机生成 SSH 密钥，把公钥添加到自己的 GitLab 账号后，IDEA 内置的 git 能用对应的私钥直接和 GitLab 完成身份认证，从而实现克隆、拉取、推送时免输入账号密码。

1. 终端执行命令生成 SSH 密钥：

ssh-keygen -t ed25519 -C "你的GitLab邮箱"

如果提示 unknown key type ed25519 再退一步用 RSA:

ssh-keygen -t rsa -b 4096 -C "你的GitLab邮箱"

2. 终端会提示保存路径，默认路径是~/.ssh/id_ed25519 或 ~/.ssh/id_rsa
3. 如果提示 Enter passphrase（设置密钥密码），可以输入密码并且需要记住，或者不想设置则直接回车两次。
4. 成功生成密钥后，公钥文件路径是~/.ssh/id_ed25519.pub 或 ~/.ssh/id_rsa.pub
5. 查看公钥内容并且准备复制到GitLab：

   cat ~/.ssh/id_ed25519.pub
   # 如果是 RSA：
   # cat ~/.ssh/id_rsa.pub

复制内容从 ssh-ed25519 或 ssh-rsa 开始，到邮箱结尾，不要多空格和换行。

四、在 GitLab 中添加 SSH

登陆 GitLab，点击右上角头像 -> Preferences ->左侧菜单 SSH Keys -> 刚刚复制的公钥内容。

五、测试 SSH 连接

在终端执行以下命令：

ssh -T git@gitlab.com
# 如果是公司私有 GitLab，比如 gitlab.xxx.com：
# ssh -T git@gitlab.xxx.com

如果 SSH 连接配置成功，会出现类似提示：

Welcome to GitLab, @your_username!

六、GitLab的2FA认证

有的公司在GitLab上需要启用双因素认证（2FA）以提升账户安全性，认证位置：登陆 GitLab，点击右上角头像 -> Preferences ->左侧菜单 Account。

1. 仅提供安卓手机下载的软件：下载 Authenticator 软件，并且注册账号
2. 软件扫描 Account 界面的二维码（QR）进行绑定，然后输入随机码对应的 pin 码完成认证。