为VSCode项目配置launch.json的核心是明确调试环境、入口文件、参数及端口监听等指令，需确保本地运行时可用，推荐通过IDE自动生成并按需调整type、program等字段。

为 vscode 项目配置 launch.json，核心是告诉调试器：用什么环境、运行哪个文件、传什么参数、是否监听端口等。它不难，但细节决定能否顺利启动调试。

确认项目已支持调试（比如有 Node.js 或 Python 环境）

VSCode 本身不自带运行时，launch.json 是“指令清单”，真正执行靠你本地装好的解释器或运行时。

• Node.js 项目：确保终端里能运行 node --version
• Python 项目：确认已选好正确的 Python 解释器（Ctrl+Shift+P → “Python: Select Interpreter”）
• TypeScript 项目：通常需先生成 js 文件（通过 tsc 或启用 outFiles 源码映射）

自动生成 launch.json（推荐新手）

别手动敲——VSCode 能根据当前语言和文件智能生成基础配置。

• 打开项目根目录下的一个可执行文件（如 index.js 或 main.py）
• 按 Ctrl+Shift+D 进入运行和调试视图
• 点击顶部的 “create a launch.json file” 链接
• 选择环境（如 “Node.js” 或 “Python”），再选模板（如 “Node.js: Launch Program”）
• VSCode 会在 .vscode/launch.json 中生成一个带注释的示例

常用字段说明（以 Node.js 为例）

生成后，你可以按需调整这些关键字段：

提示词大师-python版

图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍

下载

• “type”：调试器类型，如 "node"、"python"、"pwa-node"（新版 Node 推荐）
• “request”：是启动新进程（"launch"）还是附加到已有进程（"attach"）
• “name”：调试配置名，会显示在运行面板的下拉菜单中
• “program”：入口文件路径，建议用 ${workspaceFolder} 变量，如 "${workspaceFolder}/src/index.js"
• “console”：设为 "integratedTerminal" 可在 VSCode 终端里看到输出和交互
• “env”：添加环境变量，例如 "NODE_ENV": "development"
• “sourceMaps”（TS/Babel 项目）：设为 true，并确保构建时生成 .map 文件

多配置共存与切换

一个 launch.json 可包含多个配置，用逗号分隔，每次调试前在运行面板顶部下拉选择即可。

• 比如同时定义 “启动开发服务器” 和 “运行单元测试” 两个配置
• 每个配置的 "name" 必须唯一，方便识别
• 可配合 preLaunchTask 在调试前自动构建（需先配置 tasks.json）

基本上就这些。配置一次，后续调试点几下就能跑起来——关键是入口路径写对、运行时可用、源码映射配准。不复杂但容易忽略细节。