基于文档模板的App中UIDocumentBrowserViewController文档置灰无法选中问题

这种情况我之前帮不少iOS开发者排查过，大概率是文件类型关联（UTI）或者文档浏览器的配置环节出了问题，咱们一步步来定位解决：

1. 优先检查Info.plist的UTI配置 #

这是导致文件置灰最常见的原因——文档浏览器是通过**UTI（Uniform Type Identifier）**来判断是否支持某个文件的。你需要确保Info.plist里正确配置了Markdown文件的关联：

配置CFBundleDocumentTypes #

添加或完善CFBundleDocumentTypes数组，声明你的应用可以编辑Markdown文件：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>Markdown Document</string>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>LSHandlerRank</key>
        <string>Owner</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>net.daringfireball.markdown</string> <!-- 系统内置的标准Markdown UTI -->
            <string>public.md</string> <!-- 另一种通用的Markdown UTI -->
        </array>
    </dict>
</array>

（可选）自定义UTI声明 #

如果你需要支持特殊扩展名（比如.mdown），可以添加UTExportedTypeDeclarations来自定义UTI：

<key>UTExportedTypeDeclarations</key>
<array>
    <dict>
        <key>UTTypeIdentifier</key>
        <string>com.yourcompany.markdown</string>
        <key>UTTypeDescription</key>
        <string>Custom Markdown Document</string>
        <key>UTTypeConformsTo</key>
        <array>
            <string>public.plain-text</string>
        </array>
        <key>UTTypeTagSpecification</key>
        <dict>
            <key>public.filename-extension</key>
            <array>
                <string>md</string>
                <string>markdown</string>
                <string>mdown</string>
            </array>
            <key>public.mime-type</key>
            <string>text/markdown</string>
        </dict>
    </dict>
</array>

2. 确认UIDocumentBrowserViewController的支持类型 #

在你的文档浏览器子类中，必须明确设置supportedContentTypes，让它知道要识别哪些UTI：

class MarkdownBrowserVC: UIDocumentBrowserViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        delegate = self
        
        // 这里的UTI必须和Info.plist里配置的完全一致
        supportedContentTypes = ["net.daringfireball.markdown", "public.md", "com.yourcompany.markdown"]
    }
}

如果这里的UTI和Info.plist不匹配，浏览器就会把文件判定为不支持，进而置灰。

3. 检查UIDocument子类的实现 #

你的UIDocument子类要能正确处理Markdown文件的加载和保存，确保没有逻辑错误导致浏览器认为文件无法打开：

class MarkdownDocument: UIDocument {
    var content: String = ""
    
    override func load(fromContents contents: Any, ofType typeName: String?) throws {
        // 正确解析文件内容为字符串
        if let data = contents as? Data {
            content = String(data: data, encoding: .utf8) ?? ""
        }
    }
    
    override func contents(forType typeName: String) throws -> Any {
        // 正确将字符串转为Data保存
        return content.data(using: .utf8) ?? Data()
    }
}

如果这个子类的初始化或加载逻辑抛出异常，也可能导致浏览器禁用该文件的选择。

4. 清理缓存并重启项目 #

有时候Xcode的缓存会让配置不生效，试试这几步：

• 用Cmd+Shift+K清理项目
• 删除模拟器或真机上的应用
• 重启Xcode
• 重新运行项目

5. 验证UTI关联是否生效 #

你可以在Mac终端里用mdls命令检查某个Markdown文件的UTI，确认系统识别的类型和你配置的一致：

mdls -name kMDItemContentType /path/to/your/test.md

如果输出的UTI和你Info.plist里的不匹配，说明系统没正确识别文件类型，需要调整扩展名或UTI配置。

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