本文介绍在 macOS 上从零安装 Theos 开发环境的完整步骤，包括 Command Line Tools、Git 克隆、环境变量配置及 ldid 签名工具的安装。内容涵盖 Intel 与 Apple Silicon 架构的选择差异，通过 nic.pl 创建项目并编译打包，同时提供常见错误排查方法，帮助开发者快速搭建 iOS 越狱插件开发环境。
学完本节，希望你能够：
$THEOS/bin。nic.pl 创建第一个项目，并用 make、make package 跑通一次。提示：zsh 和 bash 配置文件不一样吗？——zsh 用 或 ，bash 用 ，改对文件再 一次。
~/.zprofile~/.zshrc~/.bash_profilesource核心需求：macOS 系统 + Xcode（或至少 Command Line Tools）+ Git。建议 Xcode 和 Command Line Tools 使用较新版本，避免后续报 SDK 或架构问题。
未安装 Xcode 的话，至少需安装命令行工具，否则无法使用 git、clang 等：
xcode-select --install
mkdir -p ~/theos
git clone --recursive https://github.com/theos/theos.git ~/theos
注意：一定要带 --recursive，子模块（如 Logos 预处理器）才会一起下载。
将 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
Theos 打包出的二进制需给越狱设备使用，一般用 ldid 签名。请根据 CPU 架构选择对应版本：
Intel (x86_64)：
curl -LO https://github.com/ProcursusTeam/ldid/releases/download/v2.1.5-procursus7/ldid_macosx_x86_64
chmod +x ldid_macosx_x86_64
mkdir -p $THEOS/bin
mv ldid_macosx_x86_64 $THEOS/bin/ldid
Apple Silicon (arm64)：
curl -LO https://github.com/ProcursusTeam/ldid/releases/download/v2.1.5-procursus7/ldid_macosx_arm64
chmod +x ldid_macosx_arm64
mkdir -p $THEOS/bin
mv ldid_macosx_arm64 $THEOS/bin/ldid
注意：下错架构会报 'bad CPU type in executable'，请换另一个版本覆盖即可。
echo $THEOS
$THEOS/bin/ldid -h
$THEOS/bin/nic.pl
三条输出正常（路径正确、显示帮助信息、出现模板选择），说明环境就绪。
$THEOS/bin/nic.pl
# 选模板（例如 13. iphone/tweak 或 tweak_modern）
# 按提示填项目名、包名、作者等信息
Tweak.x（或对应源文件）编写 Hook 逻辑。make 编译。make package 打包成 deb。make install 装到设备。至此完成从安装到第一个项目的一条龙流程。
当前下载的 ldid 架构和本机 CPU 不一致。Intel 用 x86_64，Apple Silicon 用 arm64，重新下载对应版本并覆盖 $THEOS/bin/ldid 即可。
建议更新 Xcode 到最新；若只用 Command Line Tools，可重装一遍：
sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install
.zprofile/.zshrc，bash → .bash_profile）。source 对应文件，或新开一个终端窗口再试 echo $THEOS、nic.pl。--recursive」。nic.pl 创建一个 tweak，执行 make 看是否生成 dylib。| 术语 | 解释 |
|---|---|
| ldid | 越狱环境常用签名工具，给 Mach-O 签 entitlements，Theos 默认用它替代 codesign。 |
| nic.pl | Theos 的项目模板生成脚本，选模板、填信息生成项目目录和 Makefile。 |
| deb | Debian 包格式，make package 生成的就是 deb，可装到越狱设备。 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online