FileSystemAccessAPI使用教程及操作方法

File System Access API 为现代网页应用带来了突破性的本地文件操作能力——无需服务器中转或传统表单输入，只需用户一次授权，即可在安全沙箱内直接打开、读取、编辑、保存甚至遍历整个本地目录，支持精准定位写入与内容追加；它依托 showOpenFilePicker、showDirectoryPicker 和 showSaveFilePicker 等直观接口，在 Chrome、Edge 等 Chromium 浏览器中实现接近原生应用的流畅体验，同时严格遵循 HTTPS/localhost 要求、用户手势触发和权限最小化原则，让开发者既能释放强大功能，又不牺牲安全性——是构建本地优先型 Web 工具（如代码编辑器、笔记应用、配置管理器）的理想基石。

File System Access API 让网页应用可以直接读写用户本地文件，提供更接近原生应用的体验。它适用于现代 Chromium 浏览器（如 Chrome、Edge），能实现打开、保存、读取和修改文件等操作，无需依赖传统 input 元素或服务器中转。

请求访问文件或目录

通过 window.showOpenFilePicker() 或 window.showDirectoryPicker() 可让用户选择文件或文件夹。

例如打开单个文本文件：

const [fileHandle] = await window.showOpenFilePicker({ types: [{ description: 'Text files', accept: { 'text/plain': ['.txt'] } }] }); const file = await fileHandle.getFile(); const contents = await file.text(); console.log(contents);

若需访问整个目录：

const dirHandle = await window.showDirectoryPicker(); for await (const entry of dirHandle.values()) { if (entry.kind === 'file') { const file = await entry.getFile(); console.log(file.name); } }

读取与写入文件内容

获取文件句柄后，可用 getFile() 读取内容，用 createWritable() 写入数据。

写入新内容到文件：

const writable = await fileHandle.createWritable(); await writable.write('新的文件内容'); await writable.close();

追加内容可指定位置：

const writable = await fileHandle.createWritable(); await writable.write({ type: 'seek', position: file.size }); // 移动到末尾 await writable.write('\n新增一行'); await writable.close();

创建并保存新文件

使用 window.showSaveFilePicker() 弹出保存对话框，用户选择路径后即可写入。

const newFileHandle = await window.showSaveFilePicker({ suggestedName: 'untitled.txt', types: [{ description: 'Text files', accept: { 'text/plain': ['.txt'] } }] }); const writable = await newFileHandle.createWritable(); await writable.write('这是新建文件的内容'); await writable.close();

权限管理与安全限制

所有操作必须在用户手势（如点击）上下文中触发，防止恶意调用。浏览器会记住用户对特定源的授权状态。

检查是否已有写权限：

const permissions = await fileHandle.queryPermission({ mode: 'readwrite' }); if (permissions !== 'granted') { await fileHandle.requestPermission({ mode: 'readwrite' }); }

注意点：

• API 仅在 HTTPS 或 localhost 环境下可用
• 不能直接访问系统路径，必须由用户主动选择
• 部分旧浏览器不支持，需做特性检测

基本上就这些。掌握核心方法后，就能构建类似编辑器、配置工具等需要本地文件交互的应用。

好了，本文到此结束，带大家了解了《FileSystemAccessAPI使用教程及操作方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！