如果你正在为 iOS 应用做安全加固。却被繁琐的手动代码混淆流程绊住了脚步，那就先停下来看看这份结构化教程。它把每一步拆解得清晰可操作。并针对常见痛点给出实用解决办法，让你可以快速上手而不再踩坑。

一、准备工作：创建脚这篇文章件和混淆名称列表

在项目根目录下打开终端。按以下顺序操作：

1. 切换到项目目录：cd 方法/你的项目名
2. 创建脚这篇文章件：touch testCodeConfush.sh
3. 创建要混淆的名称列表文件：touch testFuns.list
4. 赋予脚本可执行权限： chmod a+x testCodeConfush.sh

痛点提醒： 如果忘记然后或第四步，后续会出现 “Permission denied” 或 “file not found” 的错误，导致整个流程中断。务必一次性完成，

为什么要单独做一个 .list 文件？

.list 用来记录所有需要被混淆的类名和方法名。通过预先收集，这一步可以避免后期在脚本中硬编码，提高维护性。

二、编写混淆脚本 testCodeConfush.sh

将下面完整内容粘贴到 testCodeConfush.sh 中：

#!老实说，/usr/bin/env bash
# -----------------------------------------
# 混淆配置
# -----------------------------------------
TABLENAME=symbols
SYMBOL_DB_FILE="symbols"
STRING_SYMBOL_FILE="testFuns.list"
HEAD_FILE="$PROJECT_DIR/$PROJECT_NAME/Configuration/testNameUpsetDefine.h"
export LC_CTYPE=C
# 创建 SQLite 数据库表
createTable {
echo "create table $TABLENAME;" | sqlite3 $SYMBOL_DB_FILE
}
# 插入键值对
insertValue {
echo "insert into $TABLENAME values;" | sqlite3 $TABLENAME
}
# 查询占位符
query {
echo "select * from $TABLENAME where src='$';" | sqlite3 $SYMBOL_DB_FILE
}
# 随机字符串生成
ramdomString {
openssl rand -base64 | tr -cd 'a-zA-Z' | head -c 12
}
rm -f $SYMBOL_DB_FILE
rm -f $HEAD_FILE
createTable
touch $HEAD_FILE
echo "//ifndef testNameUpsetDefine_h">$HEAD_FILE
echo "//define testNameUpsetDefine_h">$HEAD_FILE
echo "//confuse string at `date`">$HEAD_FILE
cat "$STRING_SYMBOL_FILE" | while read -ra line;do
if ]，n
ramdom=$
insertValue \"$line\" \"$ramdom\"
echo "//define ${line} ${ramdom}">$HEAD_FILE
fi;done，echo "//endif">$HEAD_FILE
sqlite3 $SYMBOL_DB_FILE .dump> dump.sql # 可选，用于调试查看映射表内容
echo '===== 混淆完成 ====='
echo '请检查生成的 testNameUpsetDefine.h 是否已正确放置'

关键点：

• $PROJECT_DIR / $PROJECT_NAME：
• CocoaPods / Swift 项目需调整方法：

为什么不用 Xcode 自带工具？

Xcode 本身没有提供全功能代码混淆，需要手工处理所有符号；相反，本脚本一次性完成数据库维护、随机替换还有头文件生成。大幅降低人工错误概率，

三、在 Xcode 中配置 Build Phase 与 Prefix Header

• Add Run Script Phase: Project → TARGETS → Build Phases → 点击左上角 “+” → New Run Script Phase 将下面命令粘贴进去：

  $PROJECT_DIR/testCodeConfush.sh 如有不同方法请自行调整。

IDEL 首次建立时先运行一次以生成 header: 运行后请确认控制台无报错且已经在 $PROJECTDIR/$PROJECTNAME/Configuration/ 下出现 testNameUpsetDefine.h.

PCH 配置: Build Settings → Precompile Prefix Header 设置为 YES Prefix Header 方法填写：

$/yourProject/Configuration/ConfusionPrefix.pch 此 PCH 文件里需 #import “testNameUpsetDefine.h”。如果仍报找不到该头文件，请检查第一步先是否正确生成。按理说，若提示 “Precompiled header failed”。说明 PCH 没有包含正确方法，需要重新确认前缀设置。}

PCH 示例内容 : objc #import #import \"testNameUpsetDefine.h\" 确保此行能被编译器找到；否则所有引用都会失效，

PCH 与 Target 的关联: Build Settings → Prefix Header 方法必须指向同一 PCH 文件，否则 Build 时会因缺失导入导致链接错误。若改动后仍报错，请重启 Xcode 并 Clean Build Folder。

# 常见陷阱：PCH 不生效导致“Unknown type name”错误！一定要先确认 PCH 已成功编译，再执行主目标建立。老实说，

痛点：PCH 未生效导致 build 全部失败！原因往往是 Path 错误或 Precompile 设置未开启。检查两者，一般即可解决，.

四、自动提取类名与函数名并写入列表

objc /** * 说明：获取文件夹下所有 .m/.h 文件及其中的方法名 * @param strRootPath : 要检索的根目录 */ - PE_GetFileAndFunNameWithFolder:strRootPath { NSFileManager *fileManager =;BOOL isExist =;if { NSLog，return;} NSArray *subpaths =;for { NSString *fullPath =;BOOL isDir，if { if { // 递归子目录 continue;} // 判断 名 NSString *ext =;if { // 写类名到列表 NSString *className = stringByDeletingPathExtension]; setObject:@ forKey:className];// 存为占位符 } else if { // 读取头文件中的方法声明 NSString *content =;]，} } } }\r

objc /** 获取方法声明并写入字典 */\r - PE_GetFunNameWithStrData:strContent WithHeaderName:header {\r NSArray *lines = ];\r for {\r NSString *trimLine=];\r if||){\r // 简单解析函数名\r NSRange range=;怎么说呢，\r if{\r NSString* beforeParen=;\r NSArray* parts=];\r NSString* func=;// 最终一个元素即函数名\r func=];\r setObject: forKey:functions]\;\r"

如何把字典导出成 testFuns.list

objc\r\ NSMutableArray* names=init];for{，}

writeToFile:@"./testFuns.list" atomically:YES encoding:NSUTF8StringEncoding error:nil];

小结 这段代码做了两件事： 1️⃣ 遍历项目源文件夹，将所有 .m/.mm/.c/.cpp 文件中的类名收集进字典；2️⃣ 对每个 .h 文件逐行扫描。抽取成员函数和类函数，并一样存入字典。怎么说呢，最终把字典里的键输出到 testFuns.list。

痛点提醒：\

NSBundle mainBundle 或相对方法可能因工程结构变化导致读取失败——建议使用绝对方法或基于 XCODE_PROJECT_DIR 的相对方式。

\

writeToFile: 成功率低时可以先打印 names.count 检查是否真的收集到了数据。

\

PE_GetFunTypeWith: 原实现过于冗长，可直接用正则匹配判断 - 或 + 更稳妥。)

---

痛点	场景	快速定位	修复建议
Permission denied	创建脚本后无法执行	检查 chmod 权限未赋予或命令打错	执行 并确认无报错
header file not found	编译时报找不到	检查 PCH 方法是否指向正确目录；确保运行脚本已成功产生 header	Clean + Rebuild；重启 Xcode
SQLite 表为空	输出映射表为空或者没有任何记录	确认 有数据且格式无误；检查 insertValue 参数顺序是否正确
随机字符串重复	混淆结果出现冲突导致崩溃	提高随机长度或加入时间戳前缀；在插入前查询数据库避免重复
IDE 报 undefined symbols	链接阶段异常停止	确认所有使用到的新符号都已替换且头文件已被引用；必要时清理 DerivedData

---

快速上手小技巧**

1. 在终端直接跑一次 /testCodeConfush.sh 看控制台日志。无需进入 Xcode，即可验证脚本逻辑是否正常。

2. 使用 Git 提交版本控制。每一步都 commit，以便回滚到任意阶段。

3. 若想更省心。可考虑专业工具如 IpaGuard提供图形化界面、一键导出类/方法名单，并支持资源文件混淆。不再需要手写正则或管理 SQLite 数据库。

---

**

通过上述五个模块，你可以从基础开始建立自己的 iOS 手动代码混淆流水线：

1️⃣ 准备好 .sh 脚本与名称列表 - ⚠️ 然后和第四步不可省略，否则后续全部失效

✅ 编写完毕后立即跑一次测试。看能否顺利生成 testNameUpsetDefine.h

✅ 配置好 Build Phase 与 Prefix Header，让编译器知道哪里去找新的定义

✅ 自动提取所有需要混淆的名字并输出名单

✅ 针对常见问题快速定位并修复

这样就能大幅度提高安全性，同时避免因“繁琐步骤”“易错”而放弃保护需求。如果时间紧迫或者想进一步提高效率，还可以考虑 IpaGuard 等专业工具。它们提供完整的一键式流程，无需自己维护数据库和正则规则。

祝你编码愉快，应用安全满分 🚀

---