You need to enable JavaScript to run this app. 前端JS报错:无法在模块外使用import,改package.json后出现require未定义错误
优惠活动
大模型
产品
解决方案
定价
更多

前端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'))的代码自然就会抛错。

针对性修复步骤

  1. 先回滚无效配置:把之前加到package.json里的"type":"module"字段删掉,这是引发第二个报错的根源,纯前端浏览器运行的项目根本不需要这个配置。
  2. 正确处理浏览器端的import语法:找到HTML文件中引入app.js的<script>标签,显式声明这是ES模块脚本:
    <!-- 错误的普通脚本引入方式,无法识别import语法 -->
    <script src="/app.js"></script>
    
    <!-- 正确的模块脚本引入方式 -->
    <script type="module" src="/app.js"></script>
    
  3. 解决浏览器原生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",也不会出现导入路径识别问题。

共存场景的补充说明

如果你的项目同时有Node侧的代码需要用ESM语法、又有旧的CommonJS代码,不要全局在package.json加"type":"module":

  • 把需要用ESM语法的文件后缀改成.mjs,Node会自动将这类文件识别为ES模块
  • 保留原有的.js后缀文件为CommonJS规范,两者可以共存,不会出现require is not defined的兼容问题

内容的提问来源于stack exchange,提问作者Sarower Jahan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 00:54:04