node · JavaScript
报错原文
SyntaxError: Cannot use import statement outside a module
这是什么意思
node 或浏览器把那个文件当作 CommonJS 脚本来读，而里面出现了 ESM 的关键字 import。除非 package.json 另有声明，.js 文件一律按 CommonJS 读；在浏览器里，则是 <script> 标签少了 type="module" 时出同样的事。npm pkg set type=module 把整个包声明为 ESM 就能解决，但从那一刻起这个包里所有 .js 都失去 require 和 __dirname，剩下的 CommonJS 文件必须一起迁移——如果只想改一个文件，把扩展名换成 .mjs 是更小、更安全的改动。
怎么修
npm pkg set type=module- 来自
- node
- JavaScript
- 15
浏览器和 node 的错误通常只告诉你什么坏了，不告诉你那个值为什么变成这样——你读了 undefined、它不是函数、它不是 JSON——所以该修的地方在抛错那一行的上游；只用 ?. 和默认值把那一行按住，同样的问题会在更远的地方、以更难辨认的样子回来。
怎么读报错
- 从第一行往下读。越往下越是工具内部的事，起因通常写在最上面。
- 有文件名和行号就从那里查——不是栈顶那一帧，而是最上面那条提到你自己写的文件的行。
- 把报错原文照样去搜，但先去掉你自己的路径和变量名，正是那些让搜索匹配不上。
- 同一种情况在不同版本里措辞不同。结果不对头，就把版本号一起加进查询。
- 粘贴修法之前，先确认它会丢掉什么。这里面有些是不能撤回的。
常见问题
Q. “SyntaxError: Cannot use import statement outside a module” 是什么意思？
node 或浏览器把那个文件当作 CommonJS 脚本来读，而里面出现了 ESM 的关键字 import。除非 package.json 另有声明，.js 文件一律按 CommonJS 读；在浏览器里，则是 <script> 标签少了 type="module" 时出同样的事。npm pkg set type=module 把整个包声明为 ESM 就能解决，但从那一刻起这个包里所有 .js 都失去 require 和 __dirname，剩下的 CommonJS 文件必须一起迁移——如果只想改一个文件，把扩展名换成 .mjs 是更小、更安全的改动。
Q. 怎么修？
npm pkg set type=module —— 执行前先看上面的说明，确认这条命令会丢掉什么。
Q. 这是哪个工具报的？
node。它属于JavaScript，报错原文有 8 个词。