换机或重装系统后,按顺序把工具装回来最省时间。这里从 Homebrew 开始,依次处理多版本管理、JDK、构建工具与数据库客户端,最后附一份常用工具清单。
安装顺序
setup 1 安装 Homebrew
setup 2 安装 wget、curl 下载命令
setup 3 用 brew 安装 nvm(Node 多版本管理)
setup 4 用 brew 安装 jenv(Java 多版本管理)
setup 5 用 brew 安装 pyenv(Python 多版本管理)
setup 6 安装 Git,官网下载对应系统的安装包
setup 7 安装 Maven 并配置环境变量
setup 8 安装 mysql-client
Homebrew
国内直连官方脚本容易超时,可用国内维护的安装脚本:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
安装完成后先确认可用:
brew --version
brew doctor
Homebrew 的安装前缀随芯片不同:Apple Silicon 为 /opt/homebrew,Intel 为 /usr/local。安装的软件都放在前缀下的 Cellar 目录。
常用命令
brew update # 更新 Homebrew 自身
brew search name # 联网搜索软件
brew install name # 安装软件
brew upgrade name # 升级软件
brew uninstall name # 卸载软件
brew reinstall name # 重新安装
brew info name # 查看软件信息与安装地址
brew cleanup # 清理缓存
brew doctor # 检查环境问题
图形界面程序(cask)用 brew install --cask name 安装。旧版本教程里的 brew cask install 已废弃,brew cask 子命令也不再使用。
下载工具
brew install wget
brew install curl
多版本管理
nvm
nvm 用于在同一台机器上安装和切换多个 Node.js 版本,通过 shell 脚本注入环境变量。
brew install nvm
mkdir ~/.nvm
在 ~/.zshrc 中追加:
export NVM_DIR="$HOME/.nvm"
source $(brew --prefix nvm)/nvm.sh
重新加载配置后检查版本并安装 Node:
source ~/.zshrc
nvm ls-remote # 查看可安装的版本
nvm install --lts # 安装最新 LTS
node -v
常用命令:
nvm list installed # 显示已安装版本
nvm list available # 显示可下载版本
nvm install 14.5.0 # 安装指定版本
nvm use 14.5.0 # 切换当前版本
nvm alias default lts/* # 设置默认版本
团队协作或长期维护的项目,建议在仓库里放 .nvmrc 固定版本,进入目录后执行 nvm use 即可。
jenv
jenv 只负责在多个 JDK 之间切换,不负责安装 JDK;安装好的 JDK 需要先用
jenv add注册。
先检查机器上已有的 JDK:
/usr/libexec/java_home -V
安装并初始化 jenv:
brew install jenv
jenv doctor
echo 'eval "$(jenv init -)"' >> ~/.zshrc
source ~/.zshrc
注册 JDK。macOS 上手动安装的 JDK 通常位于 ~/Library/Java/JavaVirtualMachines/:
jenv add ~/Library/Java/JavaVirtualMachines/jdk1.8.0_411.jdk/Contents/Home
jenv add ~/Library/Java/JavaVirtualMachines/jdk-21.0.3.jdk/Contents/Home
切换版本:
jenv versions # 查看已注册版本
jenv global 1.8 # 设置全局默认
jenv shell 21 # 只对当前 shell 生效
java -version
pyenv
pyenv 管理多个 Python 版本,与 jenv 的分工相同:安装交给它,切换也交给它。
brew install pyenv
常用命令:
pyenv --version
pyenv versions # 已安装版本,* 表示当前使用
pyenv install -l # 可安装的版本列表
pyenv install 3.11.6 # 安装指定版本
pyenv rehash # 安装后更新本地数据库
pyenv global 3.11.6 # 全局默认
pyenv local 3.11.6 # 当前目录生效,生成 .python-version
pyenv shell 3.11.6 # 仅当前 shell 生效,优先级最高
pyenv init # 配置补全
JDK
JDK 8 之后可到 Adoptium 下载,JDK 8 可到 Oracle 官网下载。注意区分 Apple Silicon 与 Intel 安装包。
安装完成后用 jenv add 注册,环境变量的切换统一交给 jenv,不再手动维护 JAVA_HOME。
Git
从 git-scm.com 下载安装包,安装完成后检查版本:
git --version
生成 SSH 公钥并添加到托管平台:
ssh-keygen -t ed25519 -C "you email"
cat ~/.ssh/id_ed25519.pub
再把公钥粘贴到 GitHub 或 Gitee 的个人配置中即可。
Maven
从 Maven 下载页 选择 Binary 包,解压后放到统一目录:
mkdir -p ~/opt/env
mv apache-maven-3.8.8 ~/opt/env
在 ~/.zshrc 中配置环境变量:
export M2_HOME=$HOME/opt/env/apache-maven-3.8.8
export M2=$M2_HOME/bin
export PATH=$M2:$PATH
source ~/.zshrc
mvn -v
国内镜像
在 ~/.m2/settings.xml 的 <mirrors> 中配置镜像,按顺序兜底:
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<mirror>
<id>huaweicloud</id>
<mirrorOf>external:*,!aliyunmaven</mirrorOf>
<name>华为云公共仓库</name>
<url>https://mirrors.huaweicloud.com/repository/maven/</url>
</mirror>
<mirror>
<id>apachemaven</id>
<mirrorOf>external:*,!aliyunmaven,!huaweicloud</mirrorOf>
<name>apache 公共仓库</name>
<url>https://repo.maven.apache.org/maven2</url>
</mirror>
mvnd
maven-mvnd(Maven Daemon)借鉴 Gradle 的常驻进程,重复构建比原生 Maven 快:
brew install mvndaemon/homebrew-mvnd/mvnd
mvnd -v
Gradle
brew install gradle
gradle --version
用 brew 安装时不需要再配置 GRADLE_HOME,bin 目录已经在前缀的 PATH 中。如果是手动解压安装,再按 Maven 的方式补充环境变量。
MySQL 客户端
brew install mysql-client
mysql-client 是 keg-only 的,不会自动软链到 PATH,需要手动加:
echo 'export PATH="'"$(brew --prefix mysql-client)"'/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
which mysqldump
OpenResty
brew install openresty/tap/openresty
安装后把 nginx 所在目录加入 PATH(前缀随芯片不同):
echo 'export PATH="'"$(brew --prefix openresty)"'/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
nginx -v
Go
从 官方下载页 或 国内镜像 下载安装包,也可以 brew install go。
配置模块代理,国内拉依赖才不会超时:
go env -w GOPROXY=https://goproxy.cn,direct
go env GOPROXY
golang.org/x 下的包在 github.com/golang 有镜像,需要源码级依赖时可以先切到 $GOPATH/src,再按目录结构克隆:
cd $(go env GOPATH)/src
git clone --depth 1 https://github.com/golang/tools.git golang.org/x/tools
git clone --depth 1 https://github.com/golang/net.git golang.org/x/net
git clone --depth 1 https://github.com/golang/sys.git golang.org/x/sys
终端
macOS 自带的 shell 已改为 zsh,无需再执行 chsh。确认当前 shell:
echo $SHELL
安装 oh-my-zsh:
sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
之前写在 ~/.bash_profile 里的环境变量要在 ~/.zshrc 中引用一次,否则切换后会出现 command not found:
echo 'source ~/.bash_profile' >> ~/.zshrc
控制台提示符可在 ~/.zshrc 中调整,例如去掉主机名、只保留用户与目录:
PS1='[dev %n]%~ %# '
chromedriver
brew install --cask chromedriver
chromedriver --version
chromedriver 必须与 Chrome 主版本一致,不一致时升级 Chrome 或重新安装。首次运行若被系统拦截,去掉隔离属性即可:
xattr -d com.apple.quarantine "$(which chromedriver)"
brew 里的 cask 版本偶尔落后于 Chrome,这种情况从 官方下载页 取对应版本,放到 PATH 中的目录(如 /opt/homebrew/bin)。
常用工具清单
命令行
| Tool name | Install command | Description |
|---|---|---|
| Wget | brew install wget | 下载工具 |
| Curl | brew install curl | 下载工具 |
| Diff | brew install diffutils | GNU 比较工具 |
| Find | brew install findutils | GNU 查找工具 |
| htop | brew install htop | 代替 top |
| Axel | brew install axel | 多线程下载 |
| Tmux | brew install tmux | 终端复用 |
| cloc | brew install cloc | 代码统计 |
| Tldr | brew install tldr | 命令示例提示 |
| Ncdu | brew install ncdu | 磁盘空间占用分析 |
| ctop | brew install ctop | Docker 容器监控 |
| Pstree | brew install pstree | 进程树查看 |
| Bash-completion | brew install bash-completion | bash 补全 |
| Graphviz | brew install graphviz | 拓扑图绘制 |
| asciinema | brew install asciinema | 终端录制 |
| wrk | brew install wrk | HTTP 压测 |
asciinema 用 asciinema rec 开始录制,按 Ctrl+D 或 exit 结束。
图形应用
| Tool name | Install command | Description |
|---|---|---|
| Macpass | brew install --cask macpass | 密码管理 |
| docker | brew install --cask docker | Docker 桌面端 |
| licecap | brew install --cask licecap | GIF 录屏 |
| Kap | brew install --cask kap | 视频录屏 |
| sequel pro | brew install --cask sequelpro | 数据库管理 |
| Keycastr | brew install --cask keycastr | 显示按键,需在隐私设置中授权 |
| Typora | brew install --cask typora | Markdown 编辑器 |
| Sogou 输入法 | 官网下载 | 中文输入法 |
IDEA 从 JetBrains 官网下载安装,使用官方授权(社区版、学生授权或公司授权均可),不建议修改 hosts 或使用来路不明的激活码,升级后容易失效且存在风险。
小结
新机恢复环境按 brew、下载工具、多版本管理、JDK、Git、Maven、数据库客户端依次推进,环境变量统一写在 ~/.zshrc 并注意引用旧的 ~/.bash_profile;其余工具按清单用 brew 补齐即可。