需先安装git并配置ssh密钥：一、按系统安装git并验证版本；二、用ssh-keygen生成ed25519密钥对；三、启动ssh-agent并添加私钥；四、复制公钥内容至剪贴板以便添加到远程平台。
如果您需要在本地系统中使用 Git 进行版本控制，并通过 SSH 协议安全地与远程代码仓库（如 GitHub、GitLab）通信，则必须先安装 Git 工具并生成、配置对应的 SSH 密钥。以下是完成该任务的具体步骤：
一、安装 Git 工具
Git 是一个分布式版本控制系统，安装后才能执行克隆、提交、推送等操作。不同操作系统需采用对应方式安装。
1、在 Ubuntu 或 Debian 系统中，打开终端并运行：sudo apt update && sudo apt install git -y。
2、在 CentOS 或 RHEL 系统中，执行：sudo yum install git -y 或 sudo dnf install git -y（视版本而定）。
3、在 macOS 上，若已安装 Homebrew，运行：brew install git；若未安装，先访问 brew.sh 获取安装命令。
4、在 Windows 上，访问 https://git-scm.com/download/win 下载安装程序，运行后按向导默认选项完成安装。
5、安装完成后，在终端或命令提示符中输入：git --version，确认输出类似 git version 2.40.0 的结果。
二、生成新的 SSH 密钥对
SSH 密钥用于在不输入密码的情况下安全认证用户身份。私钥保存在本地，公钥需添加至远程 Git 服务账户中。
1、打开终端（Linux/macOS）或 Git Bash（Windows），执行：ssh-keygen -t ed25519 -C "your_email@example.com"，其中邮箱须与远程平台注册邮箱一致。
2、按回车键接受默认保存路径 ~/.ssh/id_ed25519。
3、当提示输入 passphrase 时，可直接回车跳过（不设密码），或输入自定义口令增强安全性。
4、执行完成后，使用 ls -al ~/.ssh 查看是否生成了 id_ed25519（私钥）和 id_ed25519.pub（公钥）两个文件。
三、启动 SSH 代理并添加私钥
SSH 代理负责在会话中缓存私钥，避免每次操作都重复输入口令（如有设置）。
1、启动代理进程：eval "$(ssh-agent -s)"。
2、将私钥添加至代理：ssh-add ~/.ssh/id_ed25519。
3、若提示 Could not open a connection to your authentication agent，请确保已在当前 shell 中执行第 1 步。
4、验证密钥是否加载成功：ssh-add -l，应显示类似 256 SHA256:xxx id_ed25519 (ED25519) 的输出。
四、将公钥内容复制到剪贴板
公钥需完整粘贴至远程 Git 平台的 SSH 设置页面，任何缺失或额外空格均会导致认证失败。
1、在 Linux/macOS 终端中运行：cat ~/.ssh/id_ed25519.pub | pbcopy（macOS）或 xclip -sel clip （Ubuntu/Debian）。
2、在 Windows Git Bash 中运行：cat ~/.ssh/id_ed25519.pub | clip。
3、手动检查公钥格式：开头为 ssh-ed25519，结尾为邮箱地址，整行无换行、无空格截断。
4、若上述命令不可用，可直接用文本编辑器打开 ~/.ssh/id_ed25519.pub，全选并复制全部内容。
五、在远程平台添加 SSH 公钥
以 GitHub 为例，其他平台（GitLab、Gitee）流程类似，仅界面路径略有差异。
1、登录 GitHub 账户，点击右上角头像，选择 Settings。
2、在左侧菜单中点击 SSH and GPG keys，再点击 New SSH key 按钮。
3、在 Title 栏填写标识名称，例如 work-laptop-ubuntu。
4、在 Key 文本框中粘贴已复制的公钥内容（确保是完整一行）。
5、点击 Add SSH key 完成绑定。
六、测试 SSH 连接有效性
验证本地 SSH 配置是否能被远程平台正确识别，是确保后续 Git 操作正常的关键步骤。
1、在终端中执行：ssh -T git@github.com（GitHub）或 ssh -T git@gitlab.com（GitLab）。
2、首次连接时会提示确认主机指纹，输入 yes 并回车。
3、若看到类似 Hi username! You've successfully authenticated... 的消息，说明 SSH 配置成功。
4、若提示 Permission denied (publickey)，请检查公钥是否正确添加、私钥是否已加载、是否误用了错误的主机地址（如 github.com 写成 www.github.com）。
