MacOS沙盒应用无法读取NSUserDefaults值的问题求助

核心问题说明 #

开启沙盒后，App的运行环境和非沙盒状态完全隔离，非沙盒时期存储的NSUserDefaults数据不会自动迁移到沙盒容器里——这就是你读取到nil的主要原因。另外你配置的com.apple.security.files.user-selected.read-write权限和偏好设置读取无关，这个权限管的是用户手动选择的文件/文件夹读写，和NSUserDefaults的存储路径权限没关系。

具体解决方案 #

1. 手动迁移旧偏好数据 #

如果需要读取非沙盒时期的旧数据，得自己写代码迁移：

// 替换成你的App Bundle ID
NSString *appBundleID = @"com.yourcompany.yourapp";
NSString *oldDefaultsPath = [NSString stringWithFormat:@"~/Library/Preferences/%@.plist", appBundleID];
oldDefaultsPath = [oldDefaultsPath stringByExpandingTildeInPath];

NSDictionary *oldDefaults = [NSDictionary dictionaryWithContentsOfFile:oldDefaultsPath];
if (oldDefaults) {
    NSUserDefaults *currentDefaults = [NSUserDefaults standardUserDefaults];
    // 把旧数据逐条写入沙盒内的偏好设置
    [oldDefaults enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
        [currentDefaults setObject:obj forKey:key];
    }];
    [currentDefaults synchronize];
    
    // 可选：迁移完成后删除旧文件，避免重复执行迁移逻辑
    [[NSFileManager defaultManager] removeItemAtPath:oldDefaultsPath error:nil];
}

2. 验证沙盒内的写入逻辑 #

沙盒开启后，非沙盒时期的写入不会同步过来，所以可以先执行写入操作再测试读取：

NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
// 先写入测试值
[defaults setObject:@"sandbox-test-value" forKey:@"MyPreference"];
[defaults synchronize];
// 再读取
NSString *value = [defaults objectForKey:@"MyPreference"];

3. 跨应用共享的情况（如果需要） #

要是你的App需要和其他沙盒应用共享偏好，得配置App Groups：

• 打开Xcode的Signing & Capabilities面板，添加App Groups能力
• 创建或选择一个App Group ID（比如group.com.yourapp.shared）
• 代码里使用基于App Group的NSUserDefaults：

NSUserDefaults *sharedDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.yourapp.shared"];
NSString *sharedValue = [sharedDefaults objectForKey:@"MyPreference"];

重要提示 #

• com.apple.security.files.user-selected.read-write权限不影响NSUserDefaults的读取，别在这个配置上浪费时间。
• 沙盒模式下，偏好设置的存储路径是~/Library/Containers/你的AppBundleID/Data/Library/Preferences/，不再是原来的~/Library/Preferences/。

内容的提问来源于stack exchange，提问作者Aura