defaults

读写 macOS 应用的偏好设置（domain 与键），常用于脚本化配置。

补充说明

macOS 偏好按 domain 组织，例如 com.apple.dock、com.apple.finder；-g 或 NSGlobalDomain 表示全局域。defaults read 域 [键] 读取，write 写入，delete 删除，read-type 查看类型，export/import 整域备份与恢复。写入时要带类型标志，如 -bool、-int、-string、-array、-dict，否则字符串和数字可能存错类型。

边界：defaults 改的是用户偏好，不保证应用立即生效。多数应用启动时读取一次，必须退出重开；Dock、Finder 这类常驻进程要 killall 重启。沙盒应用的实际 plist 在 ~/Library/Containers/<bundle-id>/Data/Library/Preferences/，受 MDM 管理的键会覆盖本地写入。

常用示例

# 1. 先读再改；把整个域导出成 plist 作为备份
% defaults read com.apple.dock
% defaults export com.apple.dock ~/Desktop/dock-backup.plist

# 2. 显示 Finder 隐藏文件，然后重启 Finder 让设置生效
% defaults write com.apple.finder AppleShowAllFiles -bool true
% killall Finder

# 3. 查看某个键的实际类型，避免把整数写成字符串
% defaults read-type com.apple.dock tilesize

# 4. 删除自定义键，恢复应用默认行为
% defaults delete com.apple.dock autohide
% killall Dock

# 5. 读取全局域：深色模式存在时返回 Dark，浅色模式通常报键不存在
% defaults read -g AppleInterfaceStyle

# 6. 需要时从备份恢复整个域
% defaults import com.apple.dock ~/Desktop/dock-backup.plist
% killall Dock

易错点与排错

• 写完发现没变化：应用还在用启动时读到的旧值；退出并重开应用，Dock/Finder 用 killall 重启，必要时注销再登录。
• 不先 defaults read 或 export 就 write/delete，改错键后无法恢复原值；delete 域 会删除该域所有自定义键，影响尤其大，只想恢复一项时指定键名。
• 字符串被写成布尔或数字：defaults write 域 键 1 可能存成字符串；明确加 -int 1、-bool true、-string 1。
• 以为改了 plist 文件就生效：cfprefsd 会缓存偏好，直接编辑文件可能被覆盖；用 defaults 命令或应用自身设置界面。
• 沙盒应用的域不在 ~/Library/Preferences；找不到时查容器目录，别在错误的 plist 上反复改。
• 受 MDM 或 SIP 保护的键会忽略本地写入，defaults read 甚至显示被管理值；先确认设备管理策略。

相关命令

• osascript — 用脚本配合偏好修改后的界面操作。
• launchctl — 让配置在登录或开机时自动应用。
• screencapture — 截图路径和格式也存放在偏好域。
• security — 钥匙串与偏好中的凭据边界。
• Windows reg、注册表指南 — 对照 Windows 的配置存储。

参考链接

• Apple Developer: UserDefaults
• Apple Support: Terminal 使用手册

读完自测

合上页面，先回答，再展开对照。

1. 修改 com.apple.finder 的偏好后为什么没有立刻生效？怎样让它生效？
2. 修改前如何备份一个域？恢复时用什么命令？
3. 为什么不能直接编辑 ~/Library/Preferences 下的 plist 文件？