展开菜单
首页 精品内容 本月促销 装机必备 Windows PDF教程 macOS软件 IOS软件 Android AI 专题
全部分类

当前位置:

首页 > 编程开发 > VSCode如何配置launch.json进行代码调试

VSCode如何配置launch.json进行代码调试

VSCode调试时,应通过运行调试侧边栏的齿轮图标自动生成launch.json,避免手动编写导致字段缺失。配置需注意program路径准确性,并统一使用正斜杠。断点不命中需检查sourcemap、调试信息或解释器路径。全栈调试可通过compounds组合多个配置实现,后端需提前启动并监听端口。

本文目录

    VSCode调试配置:别手写launch.json,用齿轮图标自动生成

    调试配置这事儿,手动填坑可不少。尤其是launch.json,自己敲JSON很容易漏掉env、cwd、preLaunchTask这些关键字段,结果就是断点死活不触发、路径各种报错,或者模块根本找不到。

    VSCode如何配置launch.json进行代码调试

    记住一个原则:launch.json不该手写,必须通过VSCode的齿轮图标自动生成。

    用齿轮图标生成,别自己敲JSON

    具体怎么做?打开「运行和调试」侧边栏(快捷键Ctrl+Shift+D),点击顶部那个齿轮图标。VSCode会根据你已经安装的扩展(比如Python、C/C++、Node.js)自动列出对应的调试模板。选中之后,生成的launch.json不仅自带完整注释,字段语义清晰,还能自动适配当前的工作环境。

    如果点开齿轮没看到你想要的编程语言选项,通常就两个原因:要么是对应的调试扩展压根没装(比如Go语言调试需要官方的Go扩展,而不是那个Debugger for Go);要么是扩展被禁用了,或者当前工作区VSCode没识别出语言上下文(比如你都没打开一个.py文件就去点齿轮)。

    program路径写错,调试直接失败

    program这个字段,必须指向一个真实存在的可执行入口文件。它的路径解析,完全依赖于cwd(当前工作目录)的设置。一个最常见的错误就是写了相对路径,却没设置cwd,导致VSCode跑到工作区的根目录下去找文件,结果当然是“file not found”。

    这里有几个实操建议,能帮你避开不少坑:

    • 路径写法要统一:建议使用VSCode的预定义变量,比如"program": "${workspaceFolder}/dist/index.js"。如果是调试单个Python文件,直接用"program": "${file}"最省事。
    • C/C++项目要注意:program必须填编译后生成的二进制文件路径,例如"${workspaceFolder}/build/hello",可千万别填成.cpp源文件。
    • TypeScript项目有讲究:program字段只能指向编译输出的.js文件,不能是.ts源文件,否则断点根本打不进去。
    • Windows用户看过来:路径里的分隔符,请统一使用正斜杠/,避免使用反斜杠\。

    断点不命中?先查sourcemap、-g编译、解释器路径

    调试时最让人头疼的,莫过于断点变成了空心圆,按F5后程序直接跑完,鼠标悬停上去变量显示undefined。别急着怪编辑器,这通常是调试链路在某个环节断开了。

    可以按语言快速排查:

    • TypeScript/Ja vaScript项目:首先确认配置里开启了"sourceMaps": true,并且"outFiles"正确指向了输出目录,比如["${workspaceFolder}/dist/**/*.js"]。然后,去dist目录下检查index.js.map这个sourcemap文件是否存在,并且里面的sources字段是否准确指向了你工作区里的.ts源文件路径。
    • C/C++项目:90%的问题出在编译时忘了加-g调试信息。检查你的tasks.json编译任务,args参数里是否包含了"-g"。如果用的是CMake,确保设置了set(CMAKE_BUILD_TYPE Debug)。
    • Python项目:先看看VSCode右下角选择的Python解释器路径,是不是你虚拟环境里的那个python。遇到模块导入失败,优先考虑在launch.json里通过"env"字段添加PYTHONPATH,比如"env": {"PYTHONPATH": "${workspaceFolder}/src"},而不是去硬改代码里的sys.path。

    前后端一起调试,靠compounds不靠单个configuration

    launch.json里的单个configuration,一次只能启动一个调试进程。所以,所谓的“全栈调试”,本质上是通过组合多个配置来实现的:前端用一个chrome类型的配置("request": "launch")来自动打开浏览器并注入调试器;后端则用一个node类型的配置("request": "attach")去连接一个已经启动好的服务进程。

    这里有三个关键动作:

    • 后端配置:必须设置"request": "attach",并且"port"要和你在命令行启动服务时指定的调试端口一致(例如,用node --inspect=9229 server.js启动,那么配置里就写"port": 9229)。
    • 前端配置:推荐使用"type": "chrome",并设置好"url": "http://localhost:3000"(假设你的前端服务跑在3000端口),同时正确配置"webRoot"字段指向前端源代码根目录。
    • 组合配置:在launch.json的根级别,添加一个"compounds"字段,把前端和后端两个配置的name放进去。这样,当你启动这个compound时,VSCode会先执行launch类型的配置(确保服务就绪),然后再执行attach去连接。

    最后提个醒,这一点最容易被忽略:后端服务必须在VSCode尝试attach之前就已经启动完毕,并且在监听指定的调试端口。别指望compounds能自动帮你把后端进程拉起来——要实现这个,你得借助preLaunchTask或者外部的启动脚本。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    精品专题 更多
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    macOS软件

    正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

    IOS软件

    正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

    AI

    正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw macOS版
    AionClaw macOS版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy macOS版
    Loomy macOS版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

    AirBuddy 3 macOS版
    AirBuddy 3 macOS版

    AirBuddy 3 是面向 macOS 的蓝牙外设增强工具,可集中查看 AirPods、Beats 与苹果设备电量,提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。

    AirServer macOS版
    AirServer macOS版

    AirServer macOS版可把 Mac 转换为无线投屏接收端,通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面,并支持多设备同时连接、高清镜像及会话录制,适合家庭娱乐、课堂教学、会议演示和应用展示。

    AnyDesk macOS版
    AnyDesk macOS版

    AnyDesk macOS版是一款适用于远程办公、设备维护和客户支持的远程桌面工具,可连接并操作异地计算机,支持文件传输、无人值守访问、会话权限控制及跨平台协作。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    讯飞绘文 网页版
    讯飞绘文 网页版

    讯飞绘文网页版是科大讯飞推出的AI图文创作与内容运营工具,覆盖热点选题、文章生成、稿件校对、智能配图、排版发布和数据复盘等环节,适合自媒体创作者及内容团队在线使用。

    Maya(Autodesk Maya) Windows版
    Maya(Autodesk Maya) Windows版

    Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件,集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体,

    Aperty Windows版
    Aperty Windows版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw Windows版
    AionClaw Windows版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy Windows版
    Loomy Windows版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。