如何让Electron中C++编译的Wasm直接访问本地文件系统

Wasm本身无法直接绕过沙箱限制访问本地文件系统，但借助Electron的Node.js集成能力，我们可以让Wasm通过绑定Node.js文件API的方式，实现类似“直接调用”文件操作的效果，无需每次都通过JS中转数据。

方式1：通过Emscripten绑定Node.js的fs模块 #

如果你用Emscripten编译C到Wasm，可以直接在编译时绑定Node.js的文件系统API，让C代码里的标准IO函数（如fopen、fwrite）底层由Node.js的fs模块实现。

实现步骤： #

1. 编译C++代码时指定Node.js环境
   编译时添加-s NODEJS_CATCH_EXCEPTIONS=1 -s FILESYSTEM=1参数，同时暴露需要的C++函数：

   emcc your_code.cpp -o your_module.js -s NODEJS_CATCH_EXCEPTIONS=1 -s FILESYSTEM=1 -s EXPORTED_FUNCTIONS='["_open_file", "_write_file"]'
   

2. 在C++代码中直接使用标准文件IO
   示例C++代码：

   #include <stdio.h>
   #include <string.h>
   
   extern "C" {
     void open_file(const char* path) {
       FILE* fp = fopen(path, "r");
       if (fp) {
         char buffer[1024];
         fread(buffer, 1, sizeof(buffer), fp);
         // 处理文件内容
         fclose(fp);
       }
     }
   
     void write_file(const char* path, const char* content) {
       FILE* fp = fopen(path, "w");
       if (fp) {
         fwrite(content, 1, strlen(content), fp);
         fclose(fp);
       }
     }
   }
   

   编译后，在开启Node.js集成的Electron渲染进程中加载该模块，C++里的文件操作会直接调用Node.js的fs API访问本地文件。

方式2：手动封装Node.js fs API到Wasm #

如果不想依赖Emscripten的自动绑定，也可以手动在JS层封装fs方法，再暴露给Wasm调用。

实现步骤： #

1. 在C++中声明导入函数
   定义需要从JS导入的文件操作函数：

   extern "C" {
     int read_file(const char* path, char* buffer, int buffer_size);
     int write_file(const char* path, const char* content, int content_len);
   
     void process_file(const char* path) {
       char buffer[4096];
       int bytes_read = read_file(path, buffer, sizeof(buffer));
       if (bytes_read > 0) {
         // 处理内容后写回
         write_file(path, buffer, bytes_read);
       }
     }
   }
   

2. 编译C++为独立Wasm
   禁用Emscripten虚拟文件系统，仅导出和导入指定函数：

   emcc your_code.cpp -o your_module.wasm -s STANDALONE_WASM=1 -s EXPORTED_FUNCTIONS='["_process_file"]' -s IMPORTED_FUNCTIONS='["_read_file", "_write_file"]'
   

3. 在Electron的JS层绑定fs到Wasm
   在渲染进程JS中（需开启nodeIntegration: true）：

   const fs = require('fs');
   
   async function loadWasm() {
     const wasmModule = await WebAssembly.instantiateStreaming(
       fetch('your_module.wasm'),
       {
         env: {
           _read_file: (pathPtr, bufferPtr, bufferSize) => {
             // 从Wasm内存读取路径
             const pathStr = new TextDecoder().decode(new Uint8Array(wasmModule.instance.exports.memory.buffer, pathPtr));
             try {
               const content = fs.readFileSync(pathStr);
               // 将内容写入Wasm内存缓冲区
               new Uint8Array(wasmModule.instance.exports.memory.buffer, bufferPtr, content.length).set(content);
               return content.length;
             } catch (err) {
               return -1; // 返回错误码
             }
           },
           _write_file: (pathPtr, contentPtr, contentLen) => {
             const pathStr = new TextDecoder().decode(new Uint8Array(wasmModule.instance.exports.memory.buffer, pathPtr));
             const content = new Uint8Array(wasmModule.instance.exports.memory.buffer, contentPtr, contentLen);
             try {
               fs.writeFileSync(pathStr, content);
               return 0; // 成功返回0
             } catch (err) {
               return -1;
             }
           }
         }
       }
     );
     // 调用Wasm中的文件处理函数
     const targetPath = '/path/to/user/file';
     const pathPtr = wasmModule.instance.exports.malloc(Buffer.from(targetPath).length + 1);
     new Uint8Array(wasmModule.instance.exports.memory.buffer, pathPtr).set(Buffer.from(targetPath));
     wasmModule.instance.exports._process_file(pathPtr);
     wasmModule.instance.exports.free(pathPtr);
   }
   
   loadWasm();
   

注意事项 #

• Electron安全配置：在BrowserWindow配置中需开启nodeIntegration: true（Electron 12+可能还需设置contextIsolation: false，或通过预加载脚本传递fs API）。
• 系统权限：确保Electron应用拥有目标文件的访问权限，比如macOS的文件访问授权弹窗、Windows的UAC提示。
• 路径处理：Wasm中传递的路径需为绝对路径，或通过JS层转换为绝对路径，避免相对路径异常。

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