macOS 应用沙盒容器目录(Container)结构分析

胖雪姑娘_9672

胖雪姑娘_9672

2026-08-20

944人浏览

原创

macos应用沙盒容器目录为~/library/containers//data/,由内核强制隔离,仅默认允许访问自身容器内的documents、library(含preferences/caches/application support)和tmp子目录;用户需通过nsopenpanel授权并配合security-scoped bookmarks持久化访问外部路径,且info.plist必须正确声明com.apple.security.app-sandbox等权限键。

macos 应用沙盒容器目录(container)结构分析

macOS 应用沙盒容器目录是每个启用 App Sandbox 的应用在系统中被隔离存放数据的专属空间,路径固定为:~/Library/Containers//Data/。它不是普通文件夹,而是由内核强制维护的受控环境,所有读写行为都受沙盒策略实时拦截与放行。

容器根目录下的标准子目录及其用途

进入 ~/Library/Containers/<bundle-id>/Data/</bundle-id> 后,你会看到以下常见子目录,它们有明确分工和系统级行为差异:

  • Documents:用于存放用户生成、需长期保留且可能被 Time Machine 或 iCloud 同步的数据(如文档、项目文件)。iTunes/macOS 备份时默认包含此目录。
  • Library:包含多个功能子目录:
    • Preferences:存储 NSUserDefaults 或 CFPreferences 写入的偏好设置,备份时保留;
    • Caches:存放可随时重建的缓存数据(如网络响应、缩略图),系统可能在磁盘紧张时自动清理;
    • Application Support:放置应用运行必需的支持文件(数据库、配置模板、插件等),不参与备份,但需持久化;
    • Logs 和 WebKit 等子目录则按需存在,由框架或 SDK 自动创建。
  • tmp:对应 NSTemporaryDirectory() 返回的路径,仅限临时文件。系统可能在重启后清空,且不保证内容留存;
  • Shared(非默认存在):仅当应用声明了 com.apple.security.application-groups 权限,并加入同一 Group 时才会出现,用于同组应用间安全共享数据。

哪些路径不在容器内,但可合规访问?

沙盒容器外的路径默认全部拒绝访问。只有以下三类情况例外,且均有严格前提:

macos-suite-readonly
macos-suite-readonly

macOS 只读查询:Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情(输出 JSON)。

下载
  • 用户通过 NSOpenPanel 或 NSSavePanel 显式选择的单个文件或整个文件夹(需启用 canChooseDirectories = true);
  • 经 Security-Scoped Bookmarks 持久化并正确调用 startAccessingSecurityScopedResource() / stopAccessingSecurityScopedResource() 的已授权 URL;
  • 系统级受信资源,如照片库(Photos.framework)、通讯录(Contacts.framework)、日历(EventKit)、麦克风/摄像头(需 Info.plist 中声明对应权限键并弹窗授权)。

开发中必须注意的关键细节

容器结构看似简单,但实际使用中极易因配置疏漏导致 Operation not permitted 错误:

  • Info.plist 中必须显式开启沙盒并声明所需能力,例如:com.apple.security.app-sandbox(必选)、com.apple.security.files.user-selected.read-write(访问用户选中路径)、com.apple.security.files.downloads.read-write(下载目录)等;
  • Bookmark 数据必须保存在自身容器内(如 applicationSupportDirectory),不可存到 /tmp 或硬编码全局路径;
  • 每次访问前必须调用 startAccessing...,访问结束后立即配对调用 stopAccessing...;遗漏任一环节,重启后访问即失败;
  • Xcode Capabilities 面板勾选“App Sandbox”会自动生成基础配置,但高级权限(如访问下载目录、辅助功能)仍需手动添加键值。

如何快速定位某个应用的容器路径?

不需要依赖 Xcode 或模拟器,日常开发调试可直接通过终端确认:

  • 查出目标应用的 Bundle ID(如 com.example.myapp),执行:
    ls ~/Library/Containers/com.example.myapp/Data/
  • 若不确定 Bundle ID,可在 Finder 中打开 ~/Library/Containers/,启用显示隐藏文件(Cmd+Shift+.),按应用名称大致识别文件夹名;
  • 也可用命令列出所有容器:
    ls ~/Library/Containers/ | grep -i "myapp"

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

macos

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3890

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3353

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2493

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

6010

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5642

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3313

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2825

4

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

2023.07.25

3039

6

linux查找文件命令
linux查找文件命令

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.31

297

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Miniconda官方安装文档
Miniconda官方安装文档

共0课时 | 0人学习

HBuilderX macOS 安装手册
HBuilderX macOS 安装手册

共0课时 | 0人学习