macos 上管理 sdk 依赖需区分语言级 sdk（如 java、go、rust）和底层 c/c++ 库（如 openssl、protobuf），前者用 sdkman!、g、rustup 等版本管理器统一控制，后者用 homebrew 安装并配合 pkg-config 自动注入编译路径，同时须正确配置 shell 初始化文件（如 ~/.zshrc）及环境变量（如 pkg_config_path）。
在 macOS 上管理 SDK 依赖，核心是分清两类对象：一类是语言级 SDK（如 Java、Go、Maven、Rust），另一类是底层 C/C++ 库依赖（如 OpenSSL、protobuf、libpng）。两者管理逻辑不同，需用不同工具协同配合。
用版本管理器统一控制语言级 SDK
推荐使用专为多版本设计的命令行工具，避免手动切换 PATH 或修改环境变量：
-
SDKMAN!：最适合 Java 生态（JDK、Maven、Gradle、Kotlin 等），安装后直接运行
sdk install java 21.0.3-tem或sdk install maven 4.0.0，再用sdk use java 21.0.3-tem临时切换，或sdk default java 21.0.3-tem设为全局默认 -
g 工具：专为 Go 设计，支持快速列出远程版本（
g ls-remote）、安装（g install 1.22.4）和切换（g use 1.22.4），自动处理GOROOT和PATH -
Rustup：Rust 官方推荐方式，安装后通过
rustup install stable、rustup default stable、rustup target add wasm32-unknown-unknown管理工具链与编译目标
用 Homebrew + pkg-config 管理底层 C/C++ 依赖
很多 SDK（如 Substrate、FFmpeg、OpenSSL 绑定）需要调用系统级库。Homebrew 负责安装，pkg-config 负责编译时自动注入路径：
- 先装 Homebrew（若未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 再装常用库：
brew install openssl protobuf cmake - 安装 pkg-config：
brew install pkg-config - 设置查找路径（Apple Silicon）：
export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig:/opt/homebrew/share/pkgconfig"，并写入~/.zshrc - 验证是否生效：
pkg-config --cflags openssl应输出-I/opt/homebrew/include类路径
注意环境变量与 Shell 配置的联动
SDK 工具本身不解决环境变量持久化问题，必须主动配置 shell 初始化文件：
- macOS Catalina 及之后默认使用 zsh，编辑
~/.zshrc；若用 bash，则改~/.bash_profile - 每个工具初始化语句要单独追加，例如 SDKMAN! 要加
source "$HOME/.sdkman/bin/sdkman-init.sh"，g 工具要加source "$HOME/.g/env" - 修改后务必执行
source ~/.zshrc生效，新开终端才能识别新命令 - 若多个工具都设了
JAVA_HOME或GOROOT，以最后加载的为准；建议只让一个工具（如 SDKMAN!）负责管理，其他工具禁用相关环境变量
常见冲突与排查建议
当出现 “command not found” 或 “library not found” 时，按顺序检查：
- 运行
which sdk、which g、which pkg-config，确认命令是否在 PATH 中 - 执行
echo $PATH，看是否包含/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel） - 对 C 库报错，运行
pkg-config --list-all | grep openssl，若无输出，说明PKG_CONFIG_PATH未正确设置或库未带 .pc 文件 - 某些 Homebrew 公式（如较新 ffmpeg）不提供 .pc 文件，可手动查位置：
find /opt/homebrew -name "libavcodec.pc" 2>/dev/null，再将对应目录加入PKG_CONFIG_PATH
