macOS应用沙盒是安全机制而非故障，解决方法是通过NSOpenPanel获取安全书签实现持久化路径授权，需同步配置Info.plist和entitlements文件，并严格遵循start/stop访问流程。
macOS 应用沙盒不是故障，而是安全机制主动拦截未授权的资源访问。解决核心不是“绕过”，而是让应用合规获得路径权限——尤其对模型文件、配置目录、挂载卷等非容器内资源。
确认是否真被沙盒拦截
看到 Operation not permitted 时，先别改 chmod 或禁用 SIP。重点检查：
- 报错路径是否属于
~/Documents、~/Desktop、/Volumes/下的外接盘，或~/Library/Application Support/其他App等沙盒外位置 - 运行
ls -lOe /path/to/folder，若输出含restricted或com.apple.quarantine，说明系统级管控生效 - 查
/Library/Logs/TCC/tcc.log（需提前开启日志），搜索你的 Bundle ID，确认拒绝类型是kTCCServiceFileProviderDomain（文件访问）还是kTCCServiceSystemPolicyAllFiles（全盘访问）
用 NSOpenPanel + 安全书签获取持久访问权
这是 macOS 官方唯一推荐的长期方案，适用于模型目录、自定义资源路径等需重启后仍可用的场景：
- 首次启动时调用
NSOpenPanel，设canChooseDirectories = true、resolvesAliases = true，引导用户选中目标文件夹（如/Volumes/MyModelDisk或~/Library/Application Support/MyAI） - 用户确认后立即执行
url.startAccessingSecurityScopedResource()，读写完成后立刻配对调用stopAccessingSecurityScopedResource() - 调用
url.bookmarkData(options: .withSecurityScope)生成书签数据，存入自身容器内（例如：FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first?.appending(path: "bookmarks.dat")） - 下次启动时，用
URL.resolvingBookmarkData(_:)恢复 URL，并再次startAccessing才能读写
Info.plist 与 entitlements 必须同步配置
缺一不可，否则即使用户点过授权也会失败：
- 在
Info.plist中添加键：com.apple.security.files.user-selected.read-write，值为true - 若涉及网络加载（如远程模型 URL、本地 API 调用），还需在
.entitlements文件中加入：<key>com.apple.security.network.client</key><true/><key>com.apple.security.network.server</key><true/> - Xcode Capabilities 中勾选 “User Selected File Access” 和 “Outgoing Connections” 可自动生成，但务必手动打开 plist 和 entitlements 文件核对
- 修改后必须重新签名：
codesign --force --deep --sign - /Applications/YourApp.app
避开常见失效陷阱
很多应用重启后突然报错，往往卡在这几个细节上：
- 书签数据不能存在
/tmp、/var或硬编码的全局路径——沙盒应用无权读取这些位置 - 不要在主线程长时间持有
startAccessing；应遵循“最小作用域”：打开 → 读/写 → 关闭，避免跨异步回调或后台任务泄漏 - Electron / Tauri / Flutter 应用需确保书签恢复和
startAccessing在BrowserWindow创建前完成，否则窗口初始化可能触发未授权访问 - 绝对不要依赖
temporary-exception权限提交 App Store 审核——苹果明确拒收，且该权限在 macOS 13+ 已逐步弃用
