启动Snowpack时遭遇'fs'模块找不到的报错问题

问题原因 #

Snowpack默认面向浏览器环境构建代码，不会自动识别Node.js的内置模块，因此会将fs当作第三方npm包去查找。但fs是Node.js原生内置模块，不需要通过npm安装，这就导致了报错。

解决方案 #

1. 开启Node内置模块自动处理

在项目根目录的snowpack.config.js中添加以下配置：

export default {
  installOptions: {
    polyfillNode: true,
  },
};

该配置会让Snowpack自动处理Node内置模块的映射，解决找不到fs的问题。

2. 手动配置别名映射（如果上述方法无效）

如果polyfillNode不生效，可以通过别名直接指向Node内置的fs模块：

export default {
  alias: {
    fs: require.resolve('fs'),
  },
};

3. 测试环境单独处理

如果你的测试文件是在Node环境下运行（比如使用Jest），确保测试脚本直接由测试框架执行，不要经过Snowpack处理。Jest等Node端测试框架本身支持import fs from 'fs'语法，无需额外配置。

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