macOS 安装 Theos 开发环境完整教程
学习目标
学完本节,希望你能够:
- 在 macOS 上从零完成 Theos 安装:Command Line Tools、克隆、环境变量、ldid、验证。
- 根据本机是 Intel 还是 Apple Silicon 选对 ldid 版本,并放到
$THEOS/bin。 - 用
nic.pl创建第一个项目,并用make、make package跑通一次。 - 遇到「bad CPU type」、环境变量不生效、Xcode 警告时,能按本节步骤排查。
提示:zsh 和 bash 配置文件不一样吗?——zsh 用
~/.zprofile或~/.zshrc,bash 用~/.bash_profile,改对文件再source一次。
一、前置准备
核心需求:macOS 系统 + Xcode(或至少 Command Line Tools)+ Git。建议 Xcode 和 Command Line Tools 使用较新版本,避免后续报 SDK 或架构问题。
二、安装步骤
1. 安装 Xcode Command Line Tools
未安装 Xcode 的话,至少需安装命令行工具,否则无法使用 git、clang 等:
xcode-select --install
2. 克隆 Theos 仓库
mkdir -p ~/theos
git clone --recursive https://github.com/theos/theos.git ~/theos
注意:一定要带 --recursive,子模块(如 Logos 预处理器)才会一起下载。
3. 配置环境变量
将 Theos 及其 bin 目录加入 PATH,方便直接使用 nic.pl、ldid 等命令。
zsh(推荐):写入 ~/.zprofile 或 ~/.zshrc:
export THEOS=~/theos
export PATH=$THEOS/bin:$PATH
bash:写入 ~/.bash_profile。
然后执行一次刷新:
source ~/.zprofile # 或 source ~/.zshrc / source ~/.bash_profile
4. 安装 ldid(签名工具)
Theos 打包出的二进制需给越狱设备使用,一般用 ldid 签名。请根据 CPU 架构选择对应版本:
Intel (x86_64):

