“Operation not permitted”错误大概率是macOS沙盒机制生效，而非传统权限问题；需通过NSOpenPanel获取用户授权、持久化安全书签，并在Info.plist中正确配置com.apple.security.files.user-selected.read-write权限键。
遇到“Operation not permitted”这类报错，大概率不是权限设错了，而是 macOS 沙盒机制在起作用——它本就不允许应用直接读写 ~/Documents、~/Desktop 或外接磁盘等位置。关键不是绕过沙盒，而是让应用走对的路径。
确认是不是沙盒拦截了操作
先别急着改权限或关 SIP，快速判断是否真被沙盒限制：
- 报错发生在访问 用户目录下的标准位置（如 ~/Documents、~/Desktop、~/Downloads）或外接卷时，基本就是沙盒行为
- 终端执行
ls -lOe ~/Documents，若输出含restricted字样，说明该路径受沙盒管控 - 查系统日志：
tail -f /Library/Logs/TCC/tcc.log | grep "你的App Bundle ID"，看拒绝类型是kTCCServiceFileProviderDomain还是kTCCServiceSystemPolicyAllFiles
用 NSOpenPanel 获取并持久化用户授权
沙盒下唯一合规的长期访问方式，是让用户主动选中文件夹，并保存安全书签：
- 启动时调用
NSOpenPanel，设置canChooseDirectories = true和resolvesAliases = true - 用户确认后，立即调用
url.startAccessingSecurityScopedResource() - 完成读写后，必须配对调用
url.stopAccessingSecurityScopedResource() - 用
url.bookmarkData(options:)生成书签数据，存入自身容器内（如~/Library/Containers/com.yourapp/Data/Library/Application Support/bookmarks.dat） - 下次启动时，用
URL.resolvingBookmarkData(_:)恢复 URL，再 startAccessing 才能继续读写
检查 Info.plist 和签名是否到位
即使用户点过授权，没配对的权限声明也会让一切失效：
- Info.plist 中必须包含键
com.apple.security.files.user-selected.read-write，值为true - Xcode Capabilities 里勾选 “User Selected File Access” 可自动生成，但建议手动核对 plist 内容
- 修改 Info.plist 后必须重新签名：
codesign --force --deep --sign - /Applications/YourApp.app - 若需访问照片库或控制屏幕，还需添加对应权限键，如
com.apple.security.assets.photos
避开常见实操陷阱
很多失败不是逻辑错，而是细节疏漏：
- 不要把 bookmarkData 存到
/tmp、/var/folders或全局路径——沙盒应用根本读不到那些地方 - 不要在主线程长时间持有
startAccessing，应遵循“最小作用域”：打开→操作→关闭 - Electron 应用要注意：BrowserWindow 创建前就得完成书签恢复和
startAccessing，否则窗口一渲染就可能触发拦截 - 如果应用需要后台持续访问某目录，不能只靠一次 open panel；必须每次访问前都
startAccessing，用完立刻stop
