如何在Qwik Endpoints中访问文件系统？解决fs模块导入报错

核心原因 #

你的项目处于ES模块模式（Qwik初始化项目默认配置），但导入语法不符合Node.js内置模块的要求，同时ES模块模式下require会被禁用。

具体解决步骤 #

1. 确认项目模块类型
   检查项目根目录的package.json，确保存在"type": "module"字段：

   {
     "type": "module",
     // 其他字段...
   }
   

   没有的话直接添加，Qwik项目默认会自带这个配置。

2. 使用正确的ES模块导入语法
   Node.js的fs模块没有默认导出，不能直接用import fs from 'fs'，需要改为以下两种方式之一：

   • 导入整个fs模块：

     import * as fs from 'fs';
     // 示例：读取文件
     fs.readFile('./test.txt', 'utf8', (err, data) => {
       if (err) throw err;
       console.log(data);
     });
     

   • 按需导入具体方法（推荐）：

     import { readFile, writeFile } from 'fs';
     

   • 如果想用Promise风格的异步API（更适配Qwik端点的异步逻辑），导入fs/promises：

     import * as fs from 'fs/promises';
     // 示例：异步读取文件
     const data = await fs.readFile('./test.txt', 'utf8');
     

3. 确保文件位置正确
   你的端点文件必须放在Qwik的路由目录下（通常是src/routes/api/），比如src/routes/api/file-reader.ts，Qwik会自动将其识别为服务器端运行的端点，此时Node.js的fs模块可以正常使用。

注意事项 #

因为项目处于ES模块模式，Node.js会禁用require方法，所以必须坚持使用ES模块的import语法。

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