gitlab与git关联

将本地 Git 与 GitLab 绑定,最推荐且标准的做法是配置 **SSH 密钥**(配置一次后,后续拉取、推送代码都不需要重复输密码)。

请打开电脑上的 **Git Bash**(或者 Windows Terminal / PowerShell),按以下 4 步操作:

---

### 第一步:配置全局用户名和邮箱

告诉 Git 你是谁,记录到每次代码提交(commit)中:

```bash
git config --global user.name "你的名字"
git config --global user.email "你在GitLab上使用的邮箱"
```
*(注:建议将邮箱填为你在 GitLab 账号上绑定的同一邮箱。)*

---

### 第二步:生成本地 SSH 密钥对

在终端中执行以下命令生成密钥(推荐更安全、更快的 `ed25519` 算法):

```bash
ssh-keygen -t ed25519 -C "你的GitLab邮箱"
```
*(如果你的系统或旧版服务器不支持 ed25519,可改用:`ssh-keygen -t rsa -b 4096 -C "你的GitLab邮箱"`)*

* 执行后终端会提示:`Enter file in which to save the key...`
* **直接一路按回车(连续按 3 次 Enter)** 即可,不需要设置额外密码。

---

### 第三步:复制生成的 SSH 公钥

生成完成后,终端执行以下命令查看并复制公钥内容:

* **如果使用的是 Git Bash**:
```bash
cat ~/.ssh/id_ed25519.pub
```
* **如果使用的是 Windows PowerShell**:
```powershell
Get-Content ~/.ssh/id_ed25519.pub
```
*(注:如果第二步使用的是 rsa 算法,文件名则是 `id_rsa.pub`)*

终端会输出一段以 `ssh-ed25519 AAAA...` 开头、以你的邮箱结尾的长字符串,**将整段内容完整复制下来**。

---

### 第四步:将公钥添加到 GitLab

1. 打开并登录你的 **GitLab 网站**(公网或公司内网 GitLab 均可)。
2. 点击右上角你的**头像**,选择 **Preferences(偏好设置 / 设置)**。
3. 在左侧菜单栏中找到并点击 **SSH Keys(SSH 密钥)**。
4. 点击 **Add new key(添加密钥)**:
* **Key**:将刚才复制的公钥整段粘贴进来;
* **Title**:可以随便起个名字(比如 `My-Work-PC`),不填通常会自动带出;
* **Expiration date(过期时间)**:如果不希望密钥经常过期,可以清空或选一个较远的时间;
5. 点击底部的 **Add key** 保存。

---

### 第五步:测试连接是否成功

回到终端中,执行以下测试命令:

* 如果是官方 GitLab:
```bash
ssh -T git@gitlab.com
```
* 如果是**公司内部部署的 GitLab**(请把域名/IP换成公司的):
```bash
ssh -T git@gitlab.xxxx.com
```

如果是第一次连接,终端会提示:
> `Are you sure you want to continue connecting (yes/no/[fingerprint])?`

输入 **`yes`** 并按回车。

如果看到类似以下欢迎信息,说明绑定彻底完成,后续即可直接用 `git clone git@...` 拉取和提交代码:
```text
Welcome to GitLab, @你的用户名!
```

posted @ 2026-09-07 18:22  金一九  阅读(28)  评论(0)    收藏  举报