showSaveFilePicker 保存不了文件是因为它仅返回 FileSystemFileHandle，必须调用 createWritable() 获取写入流并写入内容，且需显式 close()；漏步会导致静默失败、文件为空或截断。
showSaveFilePicker 为什么保存不了文件？
因为 showSaveFilePicker 只负责打开保存对话框并返回一个 FileSystemFileHandle，它本身不写入内容。你必须手动调用 createWritable() 获取写入流，再把数据写进去——漏掉这步就等于点了“保存”却没真存。
常见错误现象：showSaveFilePicker 成功返回，但磁盘上没生成文件；控制台无报错，但文件大小为 0 字节。
- 必须用
await等待createWritable()完成，否则写入会失败 - 写入后必须显式调用
writable.close()，否则文件可能被截断或不刷新 - 不能直接传字符串给
writable.write()，需转为Uint8Array或Blob
如何正确用 showSaveFilePicker 保存文本内容
适用于导出 JSON、日志、配置等纯文本场景。关键在于把字符串转成 Blob 再写入，避免编码问题（比如中文乱码）。
const handle = await window.showSaveFilePicker({
suggestedName: 'data.json',
types: [{
description: 'JSON files',
accept: { 'application/json': ['.json'] }
}]
});
const writable = await handle.createWritable();
await writable.write(new Blob(['{"name":"test"}'], { type: 'application/json' }));
await writable.close();
注意：suggestedName 是建议名，用户可修改；accept 中的 MIME 类型会影响系统过滤行为，但不是强制校验——用户仍可手动输入任意扩展名。
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
-
types是可选的，但不设会导致对话框默认显示“所有文件”，体验差 - 若想支持多格式（如 .txt / .log），在
accept对象里加多个键值对 - 写入大文本时，
Blob比逐字节Uint8Array更简洁且内存友好
保存二进制内容（如图片、PDF）的注意事项
如果要保存 ArrayBuffer、TypedArray 或 File 对象，不能直接传给 writable.write() —— 它只接受 BufferSource（如 Uint8Array）或 Blob。
常见错误：把 File 实例直接传进去，结果报 TypeError: Failed to execute 'write' on 'FileSystemWritableFileStream'。
- 从
input[type="file"]读取的File，可用await file.arrayBuffer()转成ArrayBuffer，再用new Uint8Array(arrayBuffer)构造写入源 - 若原数据已是
ArrayBuffer，直接writable.write(new Uint8Array(buffer)) - 不要用
TextEncoder处理二进制数据，它只用于字符串编码
兼容性与降级方案必须考虑
showSaveFilePicker 目前仅支持 Chrome 86+、Edge 91+、Opera 72+，Firefox 和 Safari 完全不支持。生产环境不能只依赖它。
检测方式很简单：if ('showSaveFilePicker' in window)，但别只靠这个做功能开关——用户可能禁用了“Web Platform APIs”权限，或运行在 iframe 且缺少 allow="filesystem" 属性。
- iframe 中使用必须显式添加
allow="filesystem"属性，否则抛SecurityError - HTTPS 是硬性要求，HTTP 站点下该 API 直接不可用
- 降级方案推荐：用
download属性 +URL.createObjectURL()生成临时链接，虽不能指定路径但能保基本功能
真正麻烦的是跨浏览器一致性——比如 Firefox 用户点“导出”后跳转到新页面下载，而 Chrome 用户是本地弹窗保存，这种体验割裂很难彻底抹平。
