在公司（使用 Azure DevOps，简称 ADO）完整配置 SSH 密钥并添加到 ADO 的详细步骤，一步一步来，适合第一次配置的人，不跳步骤，不省略命令，全程图文般清晰。
🧱 环境准备
操作系统：macOS
命令行工具：终端（Terminal）
平台：Azure DevOps（ADO）
目标：通过 SSH 连接 ADO Git 仓库，无需每次输入用户名密码
🪜 第一步：检查你是否已经有 SSH 密钥
打开终端，输入：
ls -al ~/.ssh
你会看到类似的输出：
id_ed25519
id_ed25519.pub
id_rsa
id_rsa.pub
known_hosts
说明你已经有密钥（可以跳过生成），但如果你不确定密钥是谁的，建议重新生成一对新的。
🪜 第二步：生成新的 SSH 密钥对
输入以下命令生成ED25519 类型的密钥（比旧的 RSA 更安全、更快）：
ssh-keygen -t ed25519 -C "你的公司邮箱"
例子：
ssh-keygen -t ed25519 -C "cody.yang@yourcompany.com"
会看到的交互：
Enter file in which to save the key (/Users/你的用户名/.ssh/id_ed25519):
直接按下回车，默认保存到 ~/.ssh/id_ed25519
然后会提示你设置密码（passphrase）：
Enter passphrase (empty for no passphrase):
建议设置一个简单但安全的密码，回车后确认：
Enter same passphrase again:
✅ 设置密码后，别人拿到你私钥也不能随意使用，更安全。
现在你就拥有了两个文件：
~/.ssh/id_ed25519（私钥）❗不能泄露
~/.ssh/id_ed25519.pub（公钥）✅要上传到 ADO
🪜 第三步：启动 SSH Agent，并加入密钥
这个步骤是为了让你的电脑记住私钥（并可选记住密码）
eval "$(ssh-agent -s)"
输出示例：
Agent pid 99999
然后把刚生成的私钥添加进去：
ssh-add ~/.ssh/id_ed25519
如果你设置了密码，它会要求你输入一次密码。
🪜 第四步：复制公钥内容（.pub）
执行以下命令：
pbcopy < ~/.ssh/id_ed25519.pub
这会把公钥内容复制到剪贴板，准备粘贴到 Azure DevOps。
👉 内容长这样（不要自己手动写）：
ssh-ed25519 AAAAC3...== cody.yang@yourcompany.com
🪜 第五步：登录 Azure DevOps 添加 SSH 公钥
1. 打开 ADO 网站
公司 ADO 地址通常是：
https://dev.azure.com/your-org-name
你可以让主管或团队成员提供地址，或者你在 onboarding 文档中找到。
2. 点击右上角头像 →
Security
3. 左侧菜单 → 选择
SSH Public Keys
点击右上角按钮+ Add添加一个新密钥：
Key Data：粘贴你刚才复制的 id_ed25519.pub 内容
Description：写上你的机器名或名字，例如：
Cody's MacBook Pro
然后点击Save
🪜 第六步：测试 SSH 是否配置成功
执行测试命令：
ssh -T git@ssh.dev.azure.com
第一次连接时你可能会看到：
The authenticity of host 'ssh.dev.azure.com (IP地址)' can't be established.
Are you sure you want to continue connecting (yes/no)?
输入：
yes
之后你会看到成功提示：
You've successfully authenticated, but Git does not provide shell access.
🎉 这表示 SSH 设置成功！
🪜 第七步：使用 SSH Clone 项目（而不是 HTTPS）
找到你的 Repo 地址
进入项目页面，在 Clone 处，选择 “SSH”，复制地址：
git@ssh.dev.azure.com:v3/your-org/your-project/your-repo
然后在本地终端运行：
git clone git@ssh.dev.azure.com:v3/your-org/your-project/your-repo
它将会使用你刚刚配置的 SSH 进行认证，不需要输入账号密码。
✅ 总结
步骤目的
1. 生成密钥创建一对公钥 + 私钥
2. 添加到 SSH Agent启用本地身份认证
3. 添加到 ADO授权访问代码仓库
4. 测试连接确保无误
5. 使用 SSH clone替代 HTTPS
在 macOS 上使用Homebrew 安装 Ruby 和 CocoaPods 的详细步骤，这种方式更现代、隔离性更好，可以避免将 Ruby gem 装到系统 Ruby 中而引发的权限问题。
✅ 为什么用 Homebrew 安装 Ruby 和 CocoaPods？
macOS 自带的 Ruby 是系统级的，修改它容易引发系统权限问题。
使用 Homebrew 安装 Ruby 可让你以用户身份管理 Ruby 和 gems，更安全。
安装 CocoaPods 这种 gem 时，不再需要sudo。
🪜 步骤一：安装 Homebrew（如果你已经安装了，可跳过）
打开终端，运行以下命令安装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，输入：
brew --version
确认安装成功。
🪜 步骤二：使用 Homebrew 安装 Ruby
brew install ruby
安装完后，你会看到提示类似：
Ruby is installed in /opt/homebrew/opt/ruby
🪜 步骤三：配置环境变量（非常重要）
你需要把 Homebrew 安装的 Ruby 添加到 PATH 中，这样你的终端才会使用它，而不是系统默认的 Ruby。
打开你的 shell 配置文件（取决于你用的是哪个 shell）：
如果你使用的是 zsh（macOS 默认 shell）：
nano ~/.zshrc
如果你使用的是 bash：
nano ~/.bash_profile
然后在文件末尾添加以下内容：
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
保存并退出（按Control + X→ 输入Y→ 回车）
然后运行下面这条命令，让更改生效：
source ~/.zshrc # 如果你用的是 zsh
# 或
source ~/.bash_profile # 如果你用的是 bash
🪜 步骤四：验证 Ruby 是否正确使用 Homebrew 的版本
which ruby
你应该看到：
/opt/homebrew/opt/ruby/bin/ruby
然后再看版本：
ruby -v
🪜 步骤五：安装 CocoaPods（不需要 sudo）
现在你就可以直接装 CocoaPods 了：
gem install cocoapods
等待片刻即可。
🪜 步骤六：验证 CocoaPods 安装
pod --version
如果你看到 CocoaPods 的版本号，说明一切 OK！
✅ 总结
步骤命令
安装 Homebrew/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装 Rubybrew install ruby
配置 PATHexport PATH="/opt/homebrew/opt/ruby/bin:$PATH"
安装 CocoaPodsgem install cocoapods
验证pod --version
手动配置 .gitconfig可以让你完全掌控自己的 Git 使用习惯，下面我一步步教你：
✅ 一、配置位置：在哪里配置？
我们主要配置的是「全局用户配置文件」，即：
~/.gitconfig
这个文件在你的用户根目录下（~是你用户的根目录，比如/Users/cody）。
✅ 二、如何手动创建或编辑
.gitconfig
方法 1：用文本编辑器打开（推荐 VS Code）
code ~/.gitconfig
如果你没装 VS Code，可以先安装，或用下面的方法。
方法 2：用终端内置编辑器 nano（简单好用）
nano ~/.gitconfig
这会打开文件，你可以直接编辑，编辑完按下：
Control + X→ 保存提示输入Y→ 回车（保存退出）
✅ 三、推荐配置内容（可以复制粘贴）
[user]
name = Cody Yang
email = codyyang.dev@gmail.com
[core]
editor = code --wait # 用 VS Code 作为默认提交信息编辑器
autocrlf = input # 保持换行统一（适用于 macOS / Linux）
[color]
ui = auto # 开启颜色高亮
[alias]
co = checkout
br = branch
ci = commit
st = status
last = log -1 HEAD
hist = log --oneline --graph --decorate --all
✅ 四、配置完成后如何验证？
在终端运行：
git config --global --list
你应该能看到你刚刚设置的内容。
例如：
user.name=Cody Yang
user.email=codyyang.dev@gmail.com
core.editor=code --wait
color.ui=auto
alias.co=checkout
...
🧠 常见补充配置（可选）
[merge]
tool = vimdiff # 使用 vimdiff 解决冲突（你也可以用其他工具）
[diff]
tool = vimdiff
[push]
default = simple # 推送时只推当前分支（比较安全）
[init]
defaultBranch = main # 初始化 repo 默认使用 main 而不是 master
📌 小贴士
~/.gitconfig是全局配置，对你所有的项目有效。
每个项目下的.git/config是局部配置，会覆盖全局配置。
配置后无需重启终端，立即生效。
✅ 总结：快速命令复习
操作命令
打开配置文件（VS Code）code ~/.gitconfig
打开配置文件（nano）nano ~/.gitconfig
查看配置git config --global --list
检查配置文件路径git config --list --show-origin
如果你告诉我你喜欢用哪种 Git 工具（CLI / GUI）、习惯用哪种分支命名、默认用哪个编辑器，我可以帮你生成一份更个性化的.gitconfig。需要吗？
网友评论