MACOS 安装配置 GIT

最新推荐文章于 2025-09-08 18:05:17 发布

原创最新推荐文章于 2025-09-08 18:05:17 发布 · 1.3k 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#git #ssh #macos

实习日记专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍了在 MACOS 系统中安装 Git，生成并添加 SSH 密钥到 ssh-agent，以及如何测试与 GitHub 的连接。通过设置 Git 用户名和邮箱，确保代码提交的归属。此外，还提供了关于 SSH 密钥存储和验证的指导。

MACOS 安装配置 GIT

安装 GIT
生成新 SSH 密钥
将 SSH 密钥添加到 ssh-agent
测试连接
参考链接

安装 GIT

打开 MACOS 命令行工具，在根目录下直接输入如下命令即可自动安装

git

输入如下命令查询 git 版本信息，注意是两个 -

git --version
## 输出版本号则表示安装成功
git version 2.30.1 (Apple Git-130)

设置 git 用户名和邮箱
在提交代码时会附带用户名和邮箱信息，从而定位到代码的负责人

git config --global user.name "your_name"
git config --global user.email "your_email@example.com"
## 使用如下命令查询 git 配置信息
git config --list

生成新 SSH 密钥

在终端输入如下命令生成新的 SSH 密钥
ed25519 表示所生成密钥的前缀名称
your_email@example.com 表示一串标识符，可以根据喜好自定义，会在该标识符基础上生成唯一的ssh密钥

ssh-keygen -t ed25519 -C "your_email@example.com"

一路 Enter
这里的账号密码推荐不设置，以免每次使用该密钥都要输入账号密码

> Generating public/private ed25519 key pair.
> Enter a file in which to save the key (/Users/you/.ssh/id_ed25519): [Press enter]
> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]

将 SSH 密钥添加到 ssh-agent

首先，检查的 ~/.ssh/config 文件是否在默认位置。
如果文件不存在，请创建该文件。

$ open ~/.ssh/config
> The file /Users/you/.ssh/config does not exist.
$ touch ~/.ssh/config

打开 ~/.ssh/config 文件，然后修改文件以包含以下行。
文件名或路径要匹配自己当前的设置。
注意：如果选择不向密钥添加密码，应该省略 UseKeychain 行

Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519

将 SSH 私钥添加到 ssh-agent 并将密码存储在密钥链中。

$ ssh-add -K ~/.ssh/id_ed25519

磁盘实例化 ssh
这个命令将凭据无限期地存储在磁盘上，供将来的Git程序使用

git config --global credential.helper store

测试连接

在 ~/.ssh/config 文件中添加如下内容

# 这里的地址是自己的gitlab地址和端口
Host gitlab.test.cn
  Port 10000

打开终端，输入以下内容：

$ ssh -T git@gitlab.test.cn
# Attempts to ssh to GitHub

您可能会看到类似如下的警告：

The authenticity of host ‘github.com (IP ADDRESS)’ can’t be established.
RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
Are you sure you want to continue connecting (yes/no)?

验证所看到消息中的指纹是否匹配 GitHub 的 RSA 公钥指纹。如果是，则输入 yes：

Hi username! You’ve successfully authenticated, but GitHub does not
provide shell access.

连接成功！

参考链接

https://git-scm.com/docs/git-credential-store
https://docs.github.com/cn/github/authenticating-to-github/connecting-to-github-with-ssh
https://www.cnblogs.com/jaelynl/p/10330042.html