当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript如何操作文件系统？FileSystemAPI详解

JavaScript如何操作文件系统？FileSystemAPI详解

2025-10-22 09:18:27 0浏览收藏

大家好，今天本人给大家带来文章《JavaScript如何操作文件系统？File System Access API详解》，文中内容主要涉及到，如果你对文章方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

File System Access API 允许网页在用户授权后读写本地文件，支持 Chrome 86+ 和 Edge 95+，通过 showOpenFilePicker() 读取文件，showSaveFilePicker() 保存文件，showDirectoryPicker() 访问文件夹，createWritable() 修改文件内容，并可请求持久化权限以减少重复授权，适用于文本编辑、笔记等需本地存储的场景。

如何利用JavaScript操作系统文件（通过File System Access API）？

JavaScript 本身在浏览器环境中无法直接访问操作系统文件系统，出于安全考虑，传统 Web API 对文件操作非常受限。但现代浏览器引入了 File System Access API，允许用户主动授权后，网页可以读取、写入和管理本地文件与文件夹。这个 API 提供了更接近原生应用的体验。

启用条件与浏览器支持

File System Access API 目前主要在基于 Chromium 的浏览器中支持（如 Chrome 86+、Edge 95+），Safari 和 Firefox 尚未支持。使用前应检查兼容性：

if ('showOpenFilePicker' in window) {
  // 可以使用 File System Access API
} else {
  alert('你的浏览器不支持此功能，请使用最新版 Chrome 或 Edge');
}

打开并读取文件

通过 showOpenFilePicker() 方法让用户选择文件，获取可操作的句柄，然后读取内容：

async function openFile() {
  try {
    const [fileHandle] = await window.showOpenFilePicker({
      types: [
        {
          description: '文本文件',
          accept: { 'text/plain': ['.txt'] }
        }
      ],
      excludeAcceptAllOption: true,
      multiple: false
    });
const file = await fileHandle.getFile();
const contents = await file.text();
console.log(contents);
return contents;
} catch (err) {
console.error('用户取消或出错：', err);
}
}

说明：
- types 定义允许选择的文件类型。
- multiple: true 可允许多选。
- 获取到 fileHandle 后，调用 getFile() 得到标准 File 对象，再读取内容。

创建并保存新文件

使用 showSaveFilePicker() 让用户指定保存路径和文件名：

async function saveFile(content) {
  const fileHandle = await window.showSaveFilePicker({
    suggestedName: 'untitled.txt',
    types: [{
      description: '文本文件',
      accept: { 'text/plain': ['.txt'] }
    }]
  });
const writable = await fileHandle.createWritable();
await writable.write(content);
await writable.close();
}

流程：
- 用户选择保存位置。
- 调用 createWritable() 创建可写流。
- 写入内容后关闭流，完成保存。

读写已有文件（修改文件）

如果已有一个文件句柄，可以直接重新写入内容：

async function updateFile(fileHandle, newContent) {
  const writable = await fileHandle.createWritable();
  await writable.write(newContent);
  await writable.close();
}

注意：必须是用户先前通过选择器授予访问权限的文件，不能随意修改任意路径文件。

访问文件夹（目录）

使用 showDirectoryPicker() 可访问整个文件夹结构：

async function openFolder() {
  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, file.size);
}
}
}

你可以遍历文件夹中的文件或子目录，并对每个文件进行读取或写入操作。

持久化权限（记住访问过的文件）

一旦用户授予某个文件或文件夹访问权限，可以请求持久保留权限：

if ((await fileHandle.queryPermission({ mode: 'readwrite' })) === 'granted') {
  // 已有权限
} else {
  // 请求权限
  await fileHandle.requestPermission({ mode: 'readwrite' });
}

浏览器可能会记住用户的信任选择，减少重复授权提示。

基本上就这些。File System Access API 让 Web 应用具备了更强的本地文件操作能力，适合编辑器、配置工具、离线笔记等场景。关键是所有操作都需用户主动触发并授权，确保安全。不复杂但容易忽略的是，每次操作都要处理用户取消或异常情况。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《JavaScript如何操作文件系统？FileSystemAPI详解》文章吧，也可关注golang学习网公众号了解相关技术文章。