在 macOS 上手动编译安装软件需完成环境准备、源码配置、编译安装三步：先装 Xcode 命令行工具和 Homebrew，再用 brew 安装 autoconf、cmake 等构建依赖；接着解压源码并根据 configure 或 CMakeLists.txt 选择对应配置方式，指定 --prefix=$HOME/local 及依赖路径；最后 make -j$(sysctl -n hw.ncpu) 编译，make install 安装，并将 $HOME/local/bin 加入 PATH。
在 macOS 上手动编译源码安装软件，核心是理清依赖、配置构建环境、正确执行 configure/make/install 三步，并处理好路径与权限问题。系统自带的工具链不完整，需依赖 Xcode Command Line Tools 和 Homebrew 补齐基础生态，否则极易卡在“找不到 cc”“CMake 版本太低”“pkg-config not found”等环节。
一、前置环境准备：Xcode 工具链 + Homebrew
macOS 不预装 GNU 编译器、make、autoconf 等标准构建工具，必须手动安装：
- 安装 Xcode Command Line Tools（非完整 Xcode）：
xcode-select --install，弹窗确认即可；验证用 clang --version 和 make --version - 安装 Homebrew（推荐包管理器）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"；完成后运行 brew doctor 检查环境 - 通过 Homebrew 安装常用构建依赖：
brew install autoconf automake libtool cmake pkg-config（多数开源项目 configure 脚本依赖这组工具）
二、获取并解压源码，进入构建目录
源码通常为 .tar.gz 或 .zip 格式，注意不要直接在 Downloads 目录编译，避免权限和路径混乱：
- 下载后移至专用工作区，例如：
mkdir -p ~/src && cd ~/src，再用 curl -O 或 wget 获取压缩包 - 解压并进入源码根目录：
tar xzf package-1.2.3.tar.gz && cd package-1.2.3；检查是否存在 configure（autotools 项目）或 CMakeLists.txt（CMake 项目） - 若无 configure，但有 autogen.sh，先运行：
./autogen.sh（可能需先 chmod +x autogen.sh）
三、配置（configure / cmake）：指定安装路径与依赖位置
macOS 的系统路径（如 /usr）受 SIP 保护，不可写；Homebrew 默认装在 /opt/homebrew（Apple Silicon）或 /usr/local（Intel），必须显式告知编译器去哪里找头文件和库：
- Autotools 项目（含 configure）常见配置方式：
./configure --prefix=$HOME/local --with-openssl=/opt/homebrew/opt/openssl
其中 $HOME/local 是推荐的用户级安装前缀（后续可加入 PATH），--with-xxx 用于指定 Homebrew 安装的依赖路径（用 brew --prefix xxx 查询） - CMake 项目示例：
cmake -B build -S . -DCMAKE_INSTALL_PREFIX=$HOME/local -DOPENSSL_ROOT_DIR=/opt/homebrew/opt/openssl
然后进入 build 目录编译：cmake --build build --parallel - 配置失败时，重点看 error 中的 “not found” 关键词，用 brew search xxx 找对应包，再用 brew install xxx 安装
四、编译与安装：控制并发、检查权限、更新环境变量
make 默认单线程，慢；安装目标默认为 root 权限，但用户级安装应避开 sudo：
- 加速编译（利用多核）：
make -j$(sysctl -n hw.ncpu)（自动取 CPU 核心数） - 安装到用户目录（无需 sudo）：
make install（前提是 configure/cmake 时用了 --prefix=$HOME/local） - 使新安装的命令生效：
将 $HOME/local/bin 加入 shell 配置文件（~/.zshrc 或 ~/.bash_profile）：
echo 'export PATH="$HOME/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证安装：
which program_name 应返回 $HOME/local/bin/program_name，再运行 program_name --version 确认
整个过程不复杂但容易忽略路径和依赖定位，尤其 Apple Silicon 与 Intel 的 Homebrew 路径不同，硬编码 /usr/local 可能导致找不到头文件。保持 prefix 统一、用 brew --prefix 查路径、避免 sudo make install，就能稳定完成大多数开源项目的本地编译安装。
