Cocoa：如何实现带透明背景窗口的NSView全屏模式？

这个问题我之前做桌面悬浮工具的时候踩过坑——默认的全屏模式确实会强制添加一个不透明的黑色背景层，得从窗口配置和全屏选项两个核心点调整才行：

1. 先配置窗口的基础透明属性（进入全屏前设置） #

首先要让窗口本身支持透明，同时去掉可能干扰的系统样式：

let window = view.window!
// 关闭窗口的不透明标记，这是实现透明的前提
window.isOpaque = false
// 设置窗口背景为完全透明
window.backgroundColor = .clear
// 移除标题栏和边框（如果你的场景不需要），避免残留样式影响透明效果
window.styleMask = [.borderless, .fullSizeContentView]
// 将窗口标记为辅助全屏窗口，避免系统为它创建独立的Space和强制黑色背景
window.collectionBehavior.insert(.fullScreenAuxiliary)

2. 用自定义选项进入全屏模式 #

调用enterFullScreenMode时不能传nil，必须指定辅助窗口相关的选项，阻止系统添加默认黑色背景：

// 配置全屏选项：标记为辅助窗口，同时禁用分屏功能
let fullScreenOptions: [NSFullScreenModeOption: Any] = [
    .fullScreenAuxiliaryWindow: true,
    .fullScreenAllowsTiling: false
]
// 进入全屏模式
view.enterFullScreenMode(window.screen!, withOptions: fullScreenOptions)

3. 确保目标NSView本身也是透明的 #

最后别忘了把你的目标View也设为透明，不然窗口透明了但View不透明也达不到效果：

view.wantsLayer = true
view.layer?.backgroundColor = NSColor.clear.cgColor
// 如果View有子视图，也要按需设置子视图的背景为透明，避免遮挡底层桌面

这样设置完成后，你的全屏NSView就会像透明覆盖层一样悬浮在桌面上方，不会再出现恼人的黑色背景了。

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