怎么在VSCode终端直接运行现代ES6语法的Node.js

大强吖_9988

大强吖_9988

2026-10-22

278人浏览

原创

node.js ≥ v14.15.1 才能原生支持 es 模块语法,因该版本起默认启用 import/export(无需 --experimental-modules 标志),且配合 package.json 中 "type": "module" 声明,使 .js 文件按 es 模块解析。

怎么在vscode终端直接运行现代es6语法的node.js

能直接运行,但前提是 Node.js 版本 ≥ v14.15.1 且 package.json 中声明 "type": "module" —— 不需要 Babel、不依赖 babel-node,也不用转码。

为什么 node -v ≥ 14.15.1 才行?

Node.js 在 v12.20.0 开始实验性支持 ES 模块(--experimental-modules),但直到 v14.15.1 才默认启用 import/export 语法(无需 flag)。低于这个版本,import 会报 Cannot use import statement outside a module 错误。

  • v12.x:必须加 node --experimental-modules xxx.mjs,且文件名强制为 .mjs
  • v13.x:仍需 flag,行为不稳定
  • v14.15.1+:只要 "type": "module" 声明,.js 文件也能用 import

package.json 里必须加 "type": "module"

这是关键一步。没有它,Node.js 默认把 .js 当作 CommonJS 模块处理,import 就是语法错误。

在项目根目录的 package.json 中添加这一行(已有其他字段就补在顶层):

用于自动切换项目中适合的node 版本
用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求,未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载
{
  "name": "my-app",
  "type": "module",
  "version": "1.0.0"
}
  • 不写这行,哪怕 Node 版本够新,import 依然报错
  • 写了之后,所有 .js 文件都按 ES 模块解析,require() 不能混用(除非用 createRequire)
  • 如果只想局部启用,可改用 .mjs 后缀,但不推荐——破坏编辑器识别和团队约定

VSCode 终端里怎么跑?就用 node xxx.js

确认上面两点后,打开 VSCode 集成终端(Ctrl + `),确保当前路径在项目根目录(有 package.json 的地方),然后直接执行:

node src/index.js
  • 别用右上角 ▶️ 按钮:它走的是调试器配置,容易因 launch.json 缺失或 runtimeExecutable 错配失败
  • 别用 babel-node:现代 Node 已原生支持,额外转码纯属拖慢启动、掩盖真实环境差异
  • 路径必须写对:ES 模块的 import 路径必须带扩展名(import { foo } from './utils.js'),否则报 ERR_MODULE_NOT_FOUND

常见报错和对应解法

遇到这些错误,基本就是上面三步中某处没对齐:

  • Cannot use import statement outside a module → 检查 package.json 是否有 "type": "module",再确认文件是否在该 package.json 所在目录下运行
  • ERR_MODULE_NOT_FOUND → import 路径缺 .js 后缀,或路径指向了 .ts/.jsx 等非 JS 文件
  • ReferenceError: require is not defined → 用了 require(),但当前是 ES 模块环境;改用 import,或通过 import { createRequire } from 'module'; const require = createRequire(import.meta.url); 临时兼容
  • node: --experimental-loader is not allowed in NODE_OPTIONS → 说明你全局设置了 NODE_OPTIONS,比如之前装过 Babel 相关工具,删掉或临时清空再试

最易被忽略的是:VSCode 终端可能继承了旧 shell 的环境变量,导致实际运行的不是你认为的那个 Node 版本;建议每次先敲 node -v 和 which node(macOS/Linux)或 where node(Windows)确认。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

2023.09.19

11009

8

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

2025.11.26

434

14

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

2026.02.10

761

17

JavaScript Node.js流处理与高效数据管道构建实践
JavaScript Node.js流处理与高效数据管道构建实践

本专题聚焦 Node.js 在大规模数据处理场景中的应用,系统讲解 Stream 流机制、背压控制、管道(Pipe)处理以及文件与网络数据流的高效传输方式。内容包括可读流、可写流、双工流与转换流的实现原理,并结合实际案例构建高性能数据处理管道,帮助开发者提升数据处理效率与系统吞吐能力。

2026.04.07

324

13

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

618

8

es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

285

5

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.04

406

5

JavaScript ES6新特性
JavaScript ES6新特性

ES6是JavaScript的根本性升级,引入let/const实现块级作用域、箭头函数解决this绑定问题、解构赋值与模板字符串简化数据处理、对象简写与模块化提升代码可读性与组织性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.24

375

12

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1415

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ECMAScript6 / ES6---十天技能课堂
ECMAScript6 / ES6---十天技能课堂

共25课时 | 2.7万人学习

HTML5/CSS3/JavaScript/ES6入门课程
HTML5/CSS3/JavaScript/ES6入门课程

共102课时 | 10.9万人学习

HTML+CSS基础与实战
HTML+CSS基础与实战

共132课时 | 19.2万人学习