1. Homebrew
macOS 下最常用的包管理工具。
1.1 安装
在终端运行官方安装脚本(需网络畅通):
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,终端会提示你运行几行配置命令,请务必按提示执行。
完成后同样需要 source ~/.zshrc。
1.2 换国内源
bash
# 用 echo 追加到 ~/.zshrc
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc
echo 'export HOMEBREW_CASK_DOWNLOAD_SOURCE="https://mirrors.tuna.tsinghua.edu.cn/homebrew-cask/downloads"' >> ~/.zprofile
echo 'export ALL_PROXY=""' >> ~/.zshrc
# 生效
source ~/.zshrc
2. 终端 Ghostty
一个高性能的终端工具,配置完后 CodeFuse IDE 里终端也能自动使用。
2.1 安装 Ghostty 与开发字体
bash
# 1. 安装 Ghostty
brew install --cask ghostty
# 2. 安装 Nerd Font(终端图标/状态栏必备)
brew install --cask font-jetbrains-mono-nerd-font
# 3. 创建配置目录(如不存在)
mkdir -p ~/.config/ghostty
如果上述字体安装一直失败,可手动安装:
bash
# 下载 JetBrainsMono.tar.xz(5.9MB 小体积版)
curl -L "https://sourceforge.net/projects/nerd-fonts.mirror/files/v3.4.0/JetBrainsMono.tar.xz/download" -o ~/Downloads/JetBrainsMono.tar.xz
# 验证大小
ls -lh ~/Downloads/JetBrainsMono.tar.xz
# 应显示约 5.9M
# 1. 创建字体目录
mkdir -p ~/Library/Fonts/JetBrainsMono
# 2. 解压(.tar.xz 格式)
tar -xf ~/Downloads/JetBrainsMono.tar.xz -C ~/Library/Fonts/JetBrainsMono --strip-components=1
# 3. 刷新字体缓存(可选)
killall -HUP cfprefsd 2>/dev/null || true
# 4. 验证
system_profiler SPFontsDataType | grep -i "JetBrainsMono Nerd"
# 有输出即表示安装成功
# 5. 重启 Ghostty,字体立即生效
2.2 写入配置
用 nano 打开:
bash
nano ~/.config/ghostty/config
Nano 操作指南(3 步完成):
| 步骤 | 按键操作 | 说明 |
|---|---|---|
| 1️⃣ 粘贴配置 | 终端内按 Cmd + V(或右键 → 粘贴) |
nano 默认不会自动缩进,直接粘贴格式不会乱 |
| 2️⃣ 保存文件 | 按 Ctrl + O → 屏幕底部出现提示 → 按 Enter 确认 |
O 代表 Write Out(写出文件) |
| 3️⃣ 退出编辑器 | 按 Ctrl + X |
若未保存会提示,已保存则直接退出 |
个人自用配置:
properties
# 终端图标
macos-icon = holographic
# 字体
font-family = "JetBrainsMono Nerd Font"
font-size = 13
font-thicken = true
# 窗口外观
background-opacity = 0.9
window-padding-x = 12
window-padding-y = 10
window-padding-balance = true
macos-titlebar-style = transparent
# 光标与选区
cursor-style = block
selection-background = "#89b4fa"
selection-foreground = "#cdd6f4"
# 性能与兼容
scrollback-limit = 50000
term = xterm-ghostty
shell-integration = zsh
💡 保存后 Ghostty 会自动重载(窗口样式类需关闭重开一次)。
附 nano 清除配置命令:
bash
> ~/.config/ghostty/config
# 按 Ctrl + C 退出
2.3 zoxide
可用来代替 autojump 的新一代目录跳转插件,配置后继续使用 j 快捷键。
bash
brew install zoxide
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
echo 'alias j="z"' >> ~/.zshrc
source ~/.zshrc
2.4 starship
配置终端的命令提示符显示效果,比如支持 git 分支信息等。
安装:
bash
brew install starship
写入配置:
bash
# 确保放在文件最后一行,避免被其他配置覆盖
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
创建配置文件:
bash
mkdir -p ~/.config
nano ~/.config/starship.toml
配置内容:
toml
format = """$directory$git_branch$git_status$character"""
add_newline = false
[directory]
home_symbol = "~"
style = "bold #89b4fa"
truncation_length = 3
[git_branch]
style = "bold #cba6f7"
format = "[$branch]($style) "
[git_status]
style = "bold #f38ba8"
format = '([]($style) )'
[character]
success_symbol = "[➜](bold #a6e3a1)"
error_symbol = "[➜](bold #f38ba8)"
生效配置:
bash
source ~/.zshrc
2.5 其他
隐藏启动时显示的 last login ... 信息:
bash
echo "" > ~/.hushlogin
3. nvm
Node.js 版本管理工具。
3.1 安装步骤
1. 一键安装
打开终端,粘贴运行:
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
💡 脚本会自动将
nvm写入~/.zshrc,并下载核心文件。如需绝对最新版,可去 GitHub Releases 替换版本号。
2. 重新加载终端配置
bash
source ~/.zshrc
如果提示找不到文件,直接关闭终端并重新打开即可(macOS 默认会自动加载)。
3. 配置国内镜像
bash
# 切换国内镜像源
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/' >> ~/.zshrc
# 切换官方源
echo 'export NVM_NODEJS_ORG_MIRROR=https://nodejs.org/dist/' >> ~/.zshrc
# 应用配置
source ~/.zshrc
4. 验证 & 安装 Node.js
bash
nvm --version # 应输出版本号(如 0.40.1)
nvm install --lts # 安装最新长期支持版(推荐日常开发)
nvm use --lts
node -v && npm -v # 检查是否生效
3.2 常用命令
bash
nvm ls-remote # 查看所有可安装版本
nvm install 22 # 安装 v22.x 最新版
nvm use 22 # 临时切换
nvm alias default 22 # 设为默认(新开终端自动使用)
nvm uninstall 18 # 卸载旧版本
4. Node 14
用于 VPC 老项目的开发。常规 nvm 安装 Node 14 方式会失败,需要通过 Rosetta 模式安装。
4.1 切换到 Rosetta 模式
bash
# 临时启动一个 Rosetta x86_64 shell(推荐先测试)
arch -x86_64 zsh
# 验证是否切换成功(应返回 "i386" 或 "x86_64")
arch
✅ 如果输出 i386 或 x86_64,说明已成功进入 Rosetta 环境。
4.2 在 Rosetta 环境中安装
保持当前终端窗口(x86_64 架构),执行:
bash
# 1. 确认 nvm 可用(如果提示找不到,先加载)
source ~/.nvm/nvm.sh
# 2. 安装 Node 14.21.3(会自动下载 darwin-x64 版本)
nvm install 14.21.3
# 3. 使用该版本
nvm use 14.21.3
# 4. (可选)设为默认版本
nvm alias default 14.21.3
🎉 安装过程应该很快,因为会直接下载官方预编译的 darwin-x64 二进制包,无需编译。
4.3 验证安装结果
bash
# 查看 Node 版本
node -v
# 应输出: v14.21.3
# 查看系统架构(确认是 x64)
node -p "process.arch"
# 应输出: 'x64'
# 查看 npm 版本
npm -v
5. npm
5.1 使用淘宝源
bash
# 设置 npm 默认使用淘宝源
npm config set registry https://registry.npmmirror.com
6. Git
6.1 配置用户和邮箱
bash
git config --global user.name xxx.yyy
git config --global user.email xxx.yyy@zzz.com
6.2 配置 SSH
- 在终端执行
ssh-keygen -t ed25519 -C "your_email@example.com"命令(替换为你的邮箱地址)。 - 按下回车键跳过设置文件存储地址(跳过后将使用默认存储地址,推荐跳过)。
- 按下两次回车键跳过设置密码和确认密码,即可生成新的 SSH Key。
复制 SSH Key:
bash
pbcopy < ~/.ssh/id_ed25519.pub
7. EasyHosts
Hosts 编辑配置工具。