Tauri 2 iOS 开发避坑指南：文件保存、Dialog 和 Documents 目录的那些坑很多开发者在把 Tau

很多开发者在把 Tauri 2 应用上架到 iOS（真机或模拟器）时，都会在文件保存这一步踩坑：明明代码代码在其他平台没问题，在 iOS 路径就返回 null，或者在「文件」App 里根本看不到自己的 App 文件夹。

下面我把最常见的几个坑总结成一份避坑科普文，帮你一次性避开这些“iOS 特色”问题。

现象：
调用 const path = await save({...}) 后，一个 0KB 的文件写入成功，但是 path 返回是 null。

避坑方法：

现象：用了 BaseDirectory.Document 保存文件后，在「文件」App → 浏览 → On My iPhone 里找不到你的 App 文件夹。

原因： iOS 沙盒机制严格控制 App 的 Documents 目录是否对「文件」App 可见。Tauri 默认生成的 iOS 项目不会自动添加暴露文件夹的配置，就算你写再多文件，文件夹也不会出现。

避坑方法（最关键的一步）：在 Info.plist 中添加以下两个 key（必须同时添加）：

<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

位置：通常在 src-tauri/gen/apple/ios/App/App/Info.plist（或你的项目对应路径），加在 <dict> 标签内，</dict> 之前。

添加后必须重新构建并安装 App（cargo tauri ios build 或用 Xcode 编译），然后：

此时你应该能看到和 App 同名的文件夹（显示名称来自 productName 或 Xcode Display Name）。

注意：这两个 key 只控制可见性，不影响代码读写。

推荐做法：

import { writeTextFile, BaseDirectory } from '@tauri-apps/plugin-fs'

await writeTextFile('my-note.md', '你的内容...', {
  dir: BaseDirectory.Document
})

优点：

如果你想让用户输入文件名，可以结合 prompt 或自定义输入框实现。

在 Tauri 2 + iOS 开发中：

避开这几个坑后，你的 Mind Elixir（或其他 App）在 iOS 上的文件保存功能就会顺畅很多。iOS 的沙盒和文件系统规则和桌面差异很大，提前了解这些“Apple 特色”能省下大量调试时间。

（本文基于 Tauri 2 常见 issue 和实际开发经验总结，iOS 规则可能随系统版本微调，建议以 Apple 官方文档为准。）

Tauri 2 iOS 开发避坑指南：文件保存、Dialog 和 Documents 目录的那些坑