这篇教程目标很简单：把 Git 在 Windows / macOS 上安装好，并把 SSH 免密配置到位。配置完成后，你可以直接用 git clone / git push 操作 GitHub / Gitee，而不需要每次输入账号密码。
你需要确认的两件事：
1）你准备用 GitHub 还是 Gitee（或都用）。
2）你是否在公司/学校网络环境（可能需要代理/镜像加速，本文会给排查思路）。
为什么推荐 SSH 而不是 HTTPS？HTTPS 也能用，但经常会遇到凭据缓存、Token 失效、客户端弹窗等问题；SSH 配一次基本长期稳定。
步骤 1：下载并安装
去 Git 官方或 Git for Windows 页面下载安装包，按默认一路 Next 即可。
关键选项建议：
- 编辑器：如果你用 VS Code，可选 VS Code；不确定就默认 Vim（后面也能改）。
- PATH：建议选“Git from the command line and also from 3rd-party software”（让终端和工具都能找到 git）。
- SSH 可执行程序：建议保持默认（通常是 OpenSSH）。
- 换行符（CRLF/LF）：默认推荐“Checkout Windows-style, commit Unix-style”（最省心）。
步骤 2：验证安装
git --version能输出版本号就说明 Git 可用。
方案 A：用系统自带安装（最省事）
在“终端”执行：
git --version如果提示安装 Command Line Tools，按提示安装即可。
方案 B：Homebrew 安装（版本更新更方便）
brew install git git --version把下面两行替换成你自己的名字和邮箱（邮箱建议与 GitHub/Gitee 账号一致）：
git config --global user.name "你的名字" git config --global user.email "you@example.com"查看是否生效：
git config --global --list步骤 1：检查是否已有 key
ls -al ~/.ssh如果看到 id_ed25519 / id_rsa 等文件，说明你可能已经有 key（不确定也没关系，可以新建一个）。
步骤 2：生成新的 Ed25519 key
ssh-keygen -t ed25519 -C "you@example.com"提示保存路径时，直接回车使用默认：~/.ssh/id_ed25519。
提示 passphrase（口令）时：
- 个人电脑建议设置一个口令（更安全）。
- 如果你需要无人值守脚本，可留空，但要配合更严格的权限控制。
步骤 3：启动 ssh-agent 并加入 key
macOS/Linux 通常如下：
eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519Windows（Git Bash）通常也可用同样命令；如果提示无法连接 agent，后面“常见报错”有排查。
步骤 1：复制公钥内容
macOS：
pbcopy < ~/.ssh/id_ed25519.pubWindows（Git Bash）：
cat ~/.ssh/id_ed25519.pub复制输出的整行（以 ssh-ed25519 开头）。
步骤 2：在平台后台添加 SSH Key
- GitHub：Settings → SSH and GPG keys → New SSH key
- Gitee：设置 → SSH公钥 → 添加公钥
随便写一个能识别设备的名字，例如：WIN-LAPTOP-2026 / MAC-MINI。
验证 GitHub：
ssh -T git@github.com验证 Gitee：
ssh -T git@gitee.com首次连接可能会提示确认指纹（yes）。如果看到类似“Hi xxx! You’ve successfully authenticated”就成功了。
查看当前远程地址：
git remote -v如果是 HTTPS（https://...），可以改成 SSH：
git remote set-url origin git@github.com:用户名/仓库名.gitGitee 类似：
git remote set-url origin git@gitee.com:用户名/仓库名.git1）Permission denied (publickey)
- 说明服务端没接受到你本机的正确公钥。
- 检查你是否把 .pub 内容完整添加到了平台后台。
- 检查你本机是否有多个 key，尝试：
ssh-add -l- 仍不行可用详细模式：
ssh -vT git@github.com2）Could not open a connection to your authentication agent
- 先执行：
eval "$(ssh-agent -s)"- 再执行：
ssh-add ~/.ssh/id_ed255193）Host key verification failed
- 通常是历史指纹缓存与当前不一致导致。不要盲目跳过校验。
- 可检查 ~/.ssh/known_hosts 中对应域名的记录，确认是否是你网络环境变化或代理引起。
4）公司网络访问慢/超时
- 优先检查网络代理、DNS、以及是否被网关拦截。
- 可以在家用网络先完成 key 配置，再回公司只做拉取推送。
- 一个设备一把 key：便于撤销与管理。
- key 标题带上设备名 + 日期：后期好维护。
- 提交前先拉取：git pull --re （团队协作更干净）。
- 遇到冲突不要慌：先看 git status，再逐个文件解决。
到这里，你的 Git + SSH 环境就算完全配置好了。后续想把 Git 用得更顺手，可以继续学习分支管理（branch）、变基（re ）和标签（tag）。
