VSCode如何配置launch.json调试_VSCode launch.json调试配置总结
VSCode如何配置launch.json调试_VSCode launch.json调试配置总结

免费影视、动漫、音乐、游戏、小说资源长期稳定更新! 👉 点此立即查看 👈
launch.json 里 program 字段填什么才不会报错
调试启动失败,十有八九是栽在了 program 路径上。这个字段必须指向一个实实在在的可执行入口文件,比如 index.js 或 main.py,而且路径得是相对于工作区根目录来写的——可不是相对于 .vscode/ 文件夹,也不是相对于你当前打开的文件。
新手常踩的几个坑,看看你中招了没:
- 把
program写成"./src/index.js",结果项目根目录下压根就没有src/这个文件夹。这在一些现代前端框架里很常见,比如 Vite,它的入口文件main.ts确实在src/里,但构建后的产物却跑到了dist/目录。 - 图省事用了绝对路径,像
"C:\project\index.js"。这么写,换台机器或者项目挪个位置,配置立马就失效了。 - 在 TypeScript 项目里,直接填了
src/app.ts。问题是,Node.js 原生并不能直接执行 .ts 文件,这时候要么得配上preLaunchTask先编译,要么就得改用ts-node这样的运行时。
那正确的姿势是什么?这里给两个主流方案:要么写成 "program": "${workspaceFolder}/src/index.ts",然后配合 runtimeExecutable 指向 ts-node;要么就先完成编译,直接调试构建后的文件,写成 "program": "${workspaceFolder}/dist/index.js"。
node 调试时 attach 和 launch 模式怎么选
这两种模式的核心区别,其实就在于“谁先启动进程”。
launch 模式是让 VSCode 亲自上阵,启动一个新进程并把调试器注入进去,非常适合从头开始运行一个脚本。而 attach 模式则是 VSCode 作为一个“连接者”,去挂载到一个已经在运行的进程上,这在调试服务器、子进程或者需要热更新的场景下特别有用。
它们的配置也有明显不同:
launch模式必须指定program,通常还会搭配args(参数)、env(环境变量)和cwd(工作目录)一起使用。attach模式则必须指定port(默认是 9229),并且目标进程在启动时就要加上--inspect或--inspect-brk标志,例如执行node --inspect-brk index.js。- 对于 Express、Fastify 这类 Web 服务,更推荐用
attach模式。这样一来,每次修改代码后就不需要重启整个调试会话,效率更高。
有个细节容易被忽略:在 Windows 系统下,如果你用 cmd 启动的 Node 进程,attach 有时会连接失败。换成 PowerShell,或者在启动命令里显式加上 --inspect=0.0.0.0:9229,通常会更稳定。
Python 调试找不到 module 或 import 报错
这个问题根源在于,VSCode 默认使用 python.defaultInterpreterPath 指定的解释器来运行代码,但它不会自动把你的项目根目录或者 src/ 文件夹加入到 Python 的模块搜索路径 PYTHONPATH 里,结果就是相对导入失败了。
解决办法按优先级从高到低排列:
- 在
launch.json的配置里直接增加环境变量:"env": {"PYTHONPATH": "${workspaceFolder}/src"}(假设你的模块都在src/下面)。 - 不用
"program",改用"module": "myapp",让 Python 以模块方式运行。这要求你的项目里必须存在myapp/__main__.py这样的文件。 - 最后,确认一下
python.defaultInterpreterPath指向的是你虚拟环境里的python解释器,而不是系统的全局 Python。
另外提个醒:配置项 "justMyCode": true 是默认开启的,它会跳过标准库和第三方包的断点。当你要调试依赖库的内部逻辑时,记得把它关掉。
调试时断点不命中?检查这三处
设了断点却变成灰色,还提示“unbound breakpoint”?先别急着重装插件,按顺序检查下面三个地方:
- Source Maps 开了吗? 对于 JS/TS 项目,
sourceMaps必须设为true,并且要确保生成的.map文件要么和源码在同一个目录,要么路径能被正确映射。 outFiles配对了没? 这个配置需要匹配你代码的实际输出路径。例如,如果编译后的文件都在dist文件夹里,就该写成:"outFiles": ["${workspaceFolder}/dist/**/*.js"]。- TypeScript 编译选项对吗? 检查
compilerOptions.sourceMap和inlineSourceMap是否已经开启。如果你用了inlineSourceMap: true,那就不需要配置outFiles了,但务必把inlineSources关掉,否则代码体积会急剧膨胀。
这里有个典型的“坑”:在使用 Vite 的开发模式下,它默认用 esbuild 打包,生成的 source map 是内联(inline)的。但 Node.js 调试器通常只认单独的 .js.map 文件。所以,对于 Vite 项目,在开发阶段更建议用 attach 模式连接浏览器进行调试,而不是试图用 launch 模式去跑 Node.js 进程。
相关攻略
角色与核心任务 你是一位顶级的文章润色专家,擅长将AI生成的文本转化为具有个人风格的专业文章。现在,请对用户提供的文章进行“人性化重写”。 你的核心目标是:在不改动原文任何事实信息、核心观点、逻辑结构、章节标题和所有图片的前提下,彻底改变原文的AI表达腔调,使其读起来像是一位资深人类专家的作品。 特
VSCode自定义侧边栏图标:深度美化你的工作区布局 怎么让自定义侧边栏图标真正显示出来 想让VSCode侧边栏换上自己的图标?这里有个关键认知需要先建立:VSCode本身并不支持通过用户设置文件,直接给任意视图“贴”上一个新图标。所谓的自定义,其本质是在你的扩展package json文件中,为v
Git插件“Compare Branches”无反应?先初始化本地仓库并确保VSCode工作区根目录为仓库根目录 话说回来,不少开发者都遇到过这个情况:在VSCode里想用Git插件对比分支,结果点那个“Compare Branches”选项,它愣是没半点反应。这通常不是什么插件坏了,根源往往在于一
VSCode 对 Node js 核心模块补全失效的主因是项目配置或语言服务异常 先明确一个核心判断:VSCode 默认就能对 Node js 核心模块(如 fs、path、http)提供基础补全。如果遇到提示缺失、参数不显示或者跳转失效,问题几乎都出在项目配置或语言服务状态上,而不是因为你插件没装
VSCode扩展预览版安装与管理的完整指南 先说一个核心情况:VSCode默认的插件市场界面,只会给你展示稳定版扩展。那些带着“实验性”新功能的预览版(Beta或Alpha),其实就藏在后台,只是需要一点“特殊操作”才能调出来。这第一步,往往就把不少人给卡住了。 VSCode 怎么安装扩展的预览版(
热门专题
热门推荐
最新公司2026年度工作总结会议主持词 各位领导、各位来宾、同事们,请就坐。 现在,我宣布,×公司——××××年度工作会议正式开始! 首先,请允许我荣幸地向大家介绍今天亲临会场的各位领导和来宾:集团公司董事长×先生、×公司总经理×先生、×公司总经理×女士、集团公司财务总监×先生。同时,出席本次会议的
学生做最好的自己演讲稿,成为最好的自己,从来不是一句空谈,它需要持续的努力、踏实的实践,以及在漫长岁月里对自我的不断打磨与提升。下面为大家整理了几篇学生做最好的自己演讲稿,希望能带来一些启发和思考。 学生做最好的自己演讲稿一 尊敬的老师们,亲爱的同学们: 大家好! 你是否也曾有过这样的时刻?羡慕旁人
为了确保活动流程顺畅、氛围融洽,一份好的主持词至关重要。它不仅能有效串联各个环节,更能营造出恰当的氛围。那么,如何撰写一份出色的主持词呢?借鉴诗词和散文诗的写作手法,往往能带来意想不到的效果。如果您正在寻找灵感,不妨参考以下由我们精心整理的“幼儿园家长会主持词开场白”系列范例,相信能为您提供切实的帮
我有一个弟弟 我有个弟弟,叫浩浩。小家伙长着一双水汪汪的大眼睛,一张小嘴总惦记着吃,脸蛋儿胖乎乎的,别提多可爱了。不过啊,这浩浩除了贪吃,还有个挺出名的特点——那就是相当“小气”。 一次“护食”风波 有回我去他家玩,人还没进门呢,就被他给拦住了。只见他嘟着嘴,两脚一叉,小手一张,牢牢挡在门口,嘴里还
说起最难忘的同学 细数下来,从幼儿园到现在,认识周鑫鑫竟然已经有十年了。时间过得可真快。 这事儿说来也巧。从三岁踏入幼儿园开始,一直到六年级的今天,我和她始终都在同一个班级。更巧的是,我的爷爷奶奶还认识她的父母,这么算下来,我俩真算得上是名副其实的“发小”了。 关于“认识”的起点 周鑫鑫总说“我们从





