如何让NSSavePanel中Type A文档支持自定义文件名无强制扩展名？

核心思路 #

通过正确配置UTI（统一类型标识符），结合NSDocument中对保存面板的动态调整，同时兼容不同macOS版本的行为，实现Type A保存时允许用户自定义任意文件名（无强制扩展名），且仍能选择三种文档格式。

步骤1：正确配置Info.plist #

给三种文档类型配置合法的UTI，其中Type A不绑定任何固定扩展名：

• Type A：
  1. 在UTExportedTypeDeclarations中注册自定义UTI（例如com.yourcompany.typea）：
     • UTTypeIdentifier：设为自定义标识符
     • UTTypeDescription：填写“Type A文档”
     • UTTypeConformsTo：可选public.data或public.item（根据文档类型选择）
     • 不要添加UTTypeTagSpecification字段（即不关联任何扩展名）
  2. 在CFBundleDocumentTypes中配置Type A：
     • CFBundleTypeName：Type A
     • CFBundleTypeRole：Editor
     • LSHandlerRank：Owner
     • LSItemContentTypes：包含上面定义的Type A的UTI
     • 不要设置CFBundleTypeExtensions
• Type B/C：按常规方式配置，绑定各自的扩展名和UTI即可。

步骤2：在NSDocument中调整保存面板逻辑 #

重写prepareSavePanel(_:)方法，针对Type A做特殊处理，同时解决不同macOS版本的提示问题：

override func prepareSavePanel(_ savePanel: NSSavePanel) -> Bool {
    let baseResult = super.prepareSavePanel(savePanel)
    
    guard fileType == "com.yourcompany.typea" else {
        return baseResult
    }
    
    // 允许用户选择其他文件类型
    savePanel.allowsOtherFileTypes = true
    // 列出所有支持的文档类型UTI
    savePanel.allowedFileTypes = [
        "com.yourcompany.typea",
        "com.yourcompany.typeb",
        "com.yourcompany.typec"
    ]
    
    // 兼容macOS 12及以下版本，避免弹出(null)扩展名提示
    if #available(macOS 13.0, *) {
        // Ventura及以上无需额外处理，UTI未绑定扩展名不会触发提示
    } else {
        savePanel.delegate = self
    }
    
    return baseResult
}

实现NSSavePanelDelegate拦截Monterey的无效提示：

extension YourDocumentClass: NSSavePanelDelegate {
    func panel(_ sender: Any, validateURL url: URL, error outError: AutoreleasingUnsafeMutablePointer<NSError?>?) -> Bool {
        guard fileType == "com.yourcompany.typea" else {
            return true
        }
        // 直接允许用户输入的任意文件名，不抛出扩展名错误
        outError?.pointee = nil
        return true
    }
}

步骤3：处理保存逻辑 #

在write(to:ofType:)方法中，根据选择的类型或URL扩展名处理保存格式：

override func write(to url: URL, ofType typeName: String) throws {
    switch typeName {
    case "com.yourcompany.typeb":
        try saveAsTypeBFormat(to: url)
    case "com.yourcompany.typec":
        try saveAsTypeCFormat(to: url)
    default:
        // 无论用户输入什么扩展名，只要是Type A就按对应格式保存
        try saveAsTypeAFormat(to: url)
    }
}

为什么之前的方案存在问题 #

1. 方案1：仅设置allowsOtherFileTypes = true但未解除Type A的UTI扩展名绑定，系统仍会强制追加默认扩展名；
2. 方案2：不设置类型标识符违反macOS 13的UTI导出要求，导致报错且保存面板不显示该类型；
3. 方案3：空扩展名会让系统认为Type A的标准扩展名是空，输入其他扩展名时触发提示；
4. 方案4：不设置扩展名在macOS 12中会触发.(null)的错误提示，需通过委托拦截。

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