Xcode中静态库配置关键在Build Settings：Header Search Paths设头文件路径，Library Search Paths设.a文件路径，Other Linker Flags加-l库名及-ObjC等链接标志。
在 macos 的 xcode 中，命令行工具本身不直接参与静态库路径配置——真正起作用的是 xcode 项目的 build settings。所谓“命令行工具配置”，实际是指通过 xcode 图形界面或 xcodebuild 命令行构建时，正确设置项目级的搜索路径与链接参数。核心在于三件事：头文件怎么找、静态库文件（.a）怎么定位、链接器怎么把它们连起来。
Header Search Paths：让编译器找到 .h 文件
静态库不自带头文件，必须手动告诉编译器去哪里找声明。在 Target → Build Settings → Header Search Paths 中添加路径：
- 推荐用相对路径：
$(SRCROOT)/Libs/include（假设你把头文件放在项目根目录下的Libs/include） - 勾选 recursive 可遍历子目录，比如
$(SRCROOT)/Libs/** - 避免绝对路径（如
/Users/name/…），否则换机器就失效 - 如果头文件需用
#include <xxx.h>（系统风格），填入 Header Search Paths；若用#include "xxx.h"（本地风格），可填入 User Header Search Paths
Library Search Paths：让链接器找到 .a 文件
这个路径决定 Xcode 在哪里查找静态库二进制文件：
- 填入
$(SRCROOT)/Libs或$(PROJECT_DIR)/Frameworks等项目内路径 - 同样建议启用 recursive，尤其当你按架构分文件夹存放（如
Libs/Release-iphoneos和Libs/Release-iphonesimulator） - 支持多路径空格分隔，例如：
$(SRCROOT)/Libs/Debug$(EFFECTIVE_PLATFORM_NAME) $(SRCROOT)/Libs/Release$(EFFECTIVE_PLATFORM_NAME)，Xcode 会自动根据当前编译目标（模拟器 or 真机）补全后缀
Other Linker Flags：告诉链接器具体链接哪个库
仅设好路径还不够，得明确指定要链接的库名：
- 在 Build Settings → Linking → Other Linker Flags 添加：
-lMyLib（对应libMyLib.a） - 若静态库含 Objective-C 分类（Category），必须加：
-ObjC，否则运行时报unrecognized selector - 若
-ObjC不生效（比如多个静态库冲突），改用更精准的：-force_load $(SRCROOT)/Libs/libMyLib.a - 注意：不要漏掉
-l前的短横线，且库名去掉lib前缀和.a后缀
验证与调试小技巧
配置完别急着跑，先确认是否生效：
- 在终端执行：
xcodebuild -project YourApp.xcodeproj -target YourTarget -showBuildSettings | grep -i "search\|link"，查看实际解析出的路径和链接参数 - 编译失败提示
library not found for -lXXX？检查Library Search Paths是否拼写错误，或.a文件是否真在该路径下 - 提示
file not found头文件？用find $(SRCROOT) -name "XXX.h"确认位置，再核对Header Search Paths是否覆盖到 - 真机+模拟器通用？用
lipo -info libXXX.a查看架构，必要时用lipo -create合并
