前端JS报错:无法在模块外使用import,改package.json后出现require未定义错误
浏览器ES模块导入报错修复指南
两个连续报错的本质原因
- 第一个报错
Cannot use import statement outside a module:浏览器默认把所有通过<script>引入的JS当成普通全局脚本处理,这类脚本的作用域是全局的,根本不支持ES模块的import语法。很多人第一次碰到这个报错都会下意识去改package.json,但这个操作完全找错了配置的作用域:package.json的type字段是给Node.js解释器用的,用来定义Node侧JS文件的模块规范,对浏览器加载脚本的逻辑没有任何影响,所以你之前给package.json加"type":"module"的操作根本解决不了这个浏览器端的报错。 - 第二个报错
require is not defined:你给package.json加了全局"type":"module"后,Node会把项目里所有.js文件都按ES模块规范解析,而ES模块环境下没有全局的require方法,项目里所有用CommonJS写法(const xxx = require('xxx'))的代码自然就会抛错。
针对性修复步骤
- 先回滚无效配置:把之前加到
package.json里的"type":"module"字段删掉,这是引发第二个报错的根源,纯前端浏览器运行的项目根本不需要这个配置。 - 正确处理浏览器端的import语法:找到HTML文件中引入
app.js的<script>标签,显式声明这是ES模块脚本:<!-- 错误的普通脚本引入方式,无法识别import语法 --> <script src="/app.js"></script> <!-- 正确的模块脚本引入方式 --> <script type="module" src="/app.js"></script> - 解决浏览器原生ESM无法识别npm裸导入的问题:
浏览器的原生ES模块不支持直接通过npm包名导入依赖(比如你写的import axios from 'axios'),会把这类写法当成相对路径请求,最终返回404。两种可选方案:- 轻量无构建场景:在HTML里引入app.js的script标签前,添加import map配置,把npm包名映射为可直接访问的ESM格式依赖地址(示例配置如下,实际使用时替换为对应版本的依赖路径即可):
<script type="importmap"> { "imports": { "axios": "对应axios的ESM格式访问路径" } } </script> - 有前端构建工具(Vite/Webpack等)的场景:不要直接把源码路径通过script标签引入页面,通过构建工具的dev server入口加载即可,工具会自动完成依赖解析、模块打包,不需要手动在script标签上加
type="module",也不会出现导入路径识别问题。
- 轻量无构建场景:在HTML里引入app.js的script标签前,添加import map配置,把npm包名映射为可直接访问的ESM格式依赖地址(示例配置如下,实际使用时替换为对应版本的依赖路径即可):
共存场景的补充说明
如果你的项目同时有Node侧的代码需要用ESM语法、又有旧的CommonJS代码,不要全局在package.json加"type":"module":
- 把需要用ESM语法的文件后缀改成
.mjs,Node会自动将这类文件识别为ES模块 - 保留原有的
.js后缀文件为CommonJS规范,两者可以共存,不会出现require is not defined的兼容问题
内容的提问来源于stack exchange,提问作者Sarower Jahan
相关产品推荐
相关产品推荐

