非文档型Cocoa/AppKit Mac应用标题栏出现空白文档图标如何解决

出现这个问题是因为自定义File菜单的新建/保存项后，AppKit默认将窗口识别为文档窗口，即使你没有配置文档类型。以下是几种解决方法：

1. 清除窗口的文档关联属性 #

在窗口控制器或窗口初始化代码中，明确告诉AppKit该窗口无关联文档：

Swift 代码： #

override func windowDidLoad() {
    super.windowDidLoad()
    // 清除关联的文档和URL
    window?.representedURL = nil
    window?.document = nil
    // 可选：移除标题栏分隔线（如果不需要）
    window?.titlebarSeparatorStyle = .none
}

Objective-C 代码： #

- (void)windowDidLoad {
    [super windowDidLoad];
    self.window.representedURL = nil;
    self.window.document = nil;
    self.window.titlebarSeparatorStyle = NSTitlebarSeparatorStyleNone;
}

2. 移除窗口的文档样式掩码 #

确保窗口不使用文档窗口的样式：

Swift 代码： #

window?.styleMask.remove(.documentWindow)

Objective-C 代码： #

self.window.styleMask &= ~NSDocumentWindowMask;

也可以在Main.storyboard中操作：选中窗口，打开Attributes Inspector，取消勾选「Document」相关的样式选项（部分Xcode版本中该选项在Style下拉菜单或窗口属性里）。

3. 检查并移除Info.plist中的文档类型配置 #

打开项目的Info.plist，如果存在CFBundleDocumentTypes键值对，直接删除该条目——这会彻底告知系统你的应用并非文档型应用。

4. 自定义菜单动作而非使用系统默认文档动作 #

确保你添加的「新建」「保存」菜单项绑定的是自定义动作方法，而非AppKit默认的newDocument:、saveDocument:等文档相关动作。比如将菜单动作设置为customNewAction:和customSaveAction:，避免触发系统的文档窗口逻辑。

内容的提问来源于stack exchange，提问作者zap.zip