vue报错Cannot use import statement outside a module

### Vue 项目中 'Cannot use import statement outside a module' 报错解决方案

当遇到 `SyntaxError: Cannot use import statement outside a module` 错误时，这通常意味着 JavaScript 文件未被识别为 ES 模块文件。为了使这些文件作为模块工作，需要确保几个配置项设置正确。

#### 修改 package.json 中的 type 字段

如果项目的根目录下的 `package.json` 文件中的 `"type"` 属性不是 `"module"` 或者不存在，则 Node.js 将默认把所有的 `.js` 文件视为 CommonJS 模块而不是 ES Modules。因此应该确认此属性已正确定义：

{
  "name": "...",
  "version": "...",
  ...
  "type": "module"
}

但是需要注意的是，在某些情况下直接将整个应用程序设为 ESM 可能会引发其他兼容性问题，特别是对于依赖于 CommonJS 的库来说[^1]。

#### 更新 Webpack 配置 (针对 Vue CLI)

对于基于 Vue CLI 构建的应用程序而言，可以通过调整 webpack 配置来解决问题。具体做法是在 vue.config.js 添加如下代码片段以支持 ES Module:

// vue.config.js
module.exports = {
    configureWebpack: config => {
        if(process.env.NODE_ENV === 'production') {
            Object.assign(config.optimization.splitChunks.cacheGroups.vendors, { 
                test(module, chunks) {
                    const moduleName = module.identifier();
                    return /[\\/]node_modules[\\/]/.test(moduleName);
                }
            });
        } else {
            config.output.libraryTarget = 'commonjs2';
        }
        
        // 确保所有入口都是ESM格式
        config.module.rules.push({
          parser: { amd: false },
          resourceQuery: /blockType=esm/,
        });

        delete config.externals;
    }
};

这段配置主要是为了让开发环境能够更好地处理 ESM 和 CJS 的混合使用情况，并移除了 externals 设置以便让 Webpack 自动解析 node_modules 下面的内容[^4]。

#### 使用 Babel 转换 Import/Export 语法

即使设置了上述选项之后仍然存在问题的话，可以考虑通过 Babel 来转换现代 JS 特性到更广泛的浏览器版本上。安装必要的 Babel 插件并更新 .babelrc 文件：

npm install --save-dev @babel/preset-env babel-plugin-transform-es2015-modules-commonjs

编辑或创建一个新的`.babelrc`文件加入以下内容：

{
  "presets": ["@babel/preset-env"],
  "plugins": [
      ["transform-es2015-modules-commonjs"]
  ]
}

这样做的目的是告诉 Babel 如何编译最新的 ECMAScript 提案特性以及如何将 ES6 导入导出语句转成向后兼容的形式[^3]。

#### 更改脚本标签类型（HTML）

最后一种可能的情况是 HTML 文档内的 `<script>` 标签缺少了 `type="module"` 属性。确保任何尝试加载 ES 模块的地方都有这个标记存在：

<script src="./main.js" type="module"></script>

这样做可以让浏览器知道这是一个遵循 ES 模块规范的资源请求[^2]。

以上就是几种常见的解决办法，可以根据实际情况选择合适的方法进行调试直至消除该错误提示。