返回

Node.js 项目中如何修复「SyntaxError: Cannot use import statement outside a module」错误？

javascript

Node.js 项目中「SyntaxError: Cannot use import statement outside a module」错误的解决方案

问题

使用 Babel 更新 Node.js 项目后，你在运行项目时可能会遇到「SyntaxError: Cannot use import statement outside a module」错误。这意味着你尝试在并非模块的 Node.js 脚本中使用「import」语句。

根本原因

在 Node.js 中，默认情况下，脚本不是模块，无法使用「import」语句。只有明确将脚本指定为模块，才能使用「import」语句。

解决方案

有多种方法可以解决这个问题：

1. 指定脚本为模块

在「index.js」文件的顶部添加以下代码：

"use strict";

这将使脚本成为一个模块。

2. 使用「require」语句

将「import」语句替换为「require」语句：

require('dotenv').config()
const {startServer} = require('./server')
startServer()

3. 更新 Babel 配置

确保 Babel 配置文件中启用了模块支持。在「.babelrc」文件中添加以下内容：

{
  "presets": ["@babel/preset-env"],
  "plugins": ["@babel/plugin-proposal-export-namespace-from"]
}

4. 尝试更早版本的 Babel

如果更新 Babel 版本后遇到错误，可以尝试使用更早版本的 Babel。在「package.json」文件中将 Babel 依赖项降级到较低版本：

"dependencies": {
  "@babel/core": "^7.0.0",
  "@babel/polyfill": "^7.6.0",
  "apollo-link-error": "^1.1.12",
  "apollo-link-http": "^1.5.16",
  "apollo-server": "^2.9.6",
  "babel-preset-es2015": "^6.24.1",
  "babel-preset-stage-2": "^6.24.1",
}

其他注意事项

  • 确保使用最新的 Node.js 版本： 较新的 Node.js 版本对模块支持更好。
  • 避免使用 HTML 中的「type=module」： 此属性通常用于浏览器，不适用于 Node.js。
  • 仔细检查项目中其他依赖项： 其他依赖项可能也会导致「import」语句问题。请确保它们也与你的 Node.js 和 Babel 版本兼容。

结论

通过以上方法，你可以解决 Node.js 项目中出现的「SyntaxError: Cannot use import statement outside a module」错误。请根据项目的实际情况选择最合适的方法。

常见问题解答

  1. 为什么在 Node.js 中，默认情况下脚本不是模块？

    • 这与 Node.js 的历史和向后兼容性有关。 Node.js 早期版本不支持模块，而将脚本指定为模块可能导致旧脚本出现问题。

  2. 可以同时使用「import」和「require」语句吗？

    • 可以，但通常不建议这样做，因为它可能会使代码难以维护。建议使用一种语句并坚持使用它。

  3. 如何检查 Babel 配置文件是否正确？

    • 运行命令「npx babel --config-file .babelrc」以验证配置文件。

  4. 降级 Babel 版本后，还需要其他更改吗？

    • 通常不需要，但建议仔细检查项目的兼容性。

  5. 此错误是否与 Node.js 版本有关？

    • 是的，更新 Node.js 版本可能会解决错误，因为较新的版本对模块的支持更好。