如何在VSCode中配置并运行JavaScript项目【教程】-VSCode-PHP中文网

VSCode不运行JavaScript项目，依赖Node.js环境；需确保Node.js路径正确、配置launch.json、初始化package.json并规范ESM导入。

如何在vscode中配置并运行javascript项目【教程】

VSCode 本身不“运行” JavaScript 项目，它靠外部环境（如 Node.js）执行代码；配置的关键是让编辑器正确识别环境、调试入口和依赖关系，而不是装一堆插件凑热闹。

确认 Node.js 已安装且被 VSCode 识别

很多报错（比如 ReferenceError: require is not defined 或 command 'node' not found）其实只是 VSCode 找不到 node 命令。不是插件问题，是路径没对齐。

终端里运行 which node（macOS/Linux）或 where node（Windows），确认输出有效路径
VSCode 终端（Ctrl+`）里也执行一遍，如果报错，说明 VSCode 启动时没加载 shell 的 PATH —— 关闭 VSCode，从终端用 code . 启动，而非桌面图标
检查 node -v 和 npm -v 能正常输出，版本建议 ≥18.0（避免旧版 fetch / glob 兼容问题）

不用插件也能直接运行单个 JS 文件

VSCode 内置的 Run Code 功能（来自 Code Runner 扩展）常被误认为必需，其实原生终端一行命令更可控，也避开了插件对 import / ESM 的各种魔改逻辑。

打开一个 index.js，右键 → “在终端中运行”，或按 Ctrl+Shift+P 输入 Terminal: Run Selected Text in Active Terminal
更推荐：终端里手动执行 node index.js —— 这样你能立刻看到错误堆栈是否来自代码本身，还是插件注入的 wrapper
如果遇到 Cannot use import statement outside a module，说明文件被当成了 CommonJS，加 "type": "module" 到 package.json，或改用 node --input-type=module -e "import('./index.js')"

调试时必须配 `.vscode/launch.json`

点绿色三角形启动调试前，VSCode 需要知道从哪开始、带什么参数、要不要监听源码映射——这些全靠 launch.json 定义，不是靠“自动检测”。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

项目根目录建 .vscode/launch.json，内容至少包含：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch index.js",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/index.js",
      "console": "integratedTerminal"
    }
  ]
}</node_internals>

program 必须写相对路径（${workspaceFolder}/xxx），不能写绝对路径或 ./xxx，否则调试器找不到文件

如果用了 TypeScript 或打包工具（如 Vite），program 指向编译后文件（如 dist/main.js），并确保 sourceMaps 开启且路径正确

依赖管理别绕过 `package.json`

有人把 JS 文件丢进文件夹就点运行，结果 require('lodash') 报错 —— 不是因为 VSCode 配置漏了，是因为根本没装包，也没声明依赖。

哪怕只跑一个脚本，也要初始化：npm init -y → npm install lodash → 在代码里用 const _ = require('lodash')
避免全局安装（npm install -g xxx）再 require，VSCode 调试时默认不读全局 node_modules
如果项目用 ESM，import 语句中的路径必须带扩展名（import { foo } from './utils.js'），Node.js 不再自动补 .js