在 macOS 的 VS Code 中配置 Python 或 Node.js 调试器需三步：安装对应扩展（Python 用官方扩展，Node.js 推荐 Extension Pack）、在项目根目录生成并编辑 launch.json（含 type、request、program 等关键字段）、按场景微调如 args、module 或 sourceMaps；无需改系统设置或手动启服务。
macos 上在 vs code 中配置 python 或 node.js 调试器，核心是三件事：装对扩展、生成正确 launch.json、按语言特性微调关键字段。不需要改系统设置，也不用命令行手动启调试服务——vs code 自动处理大部分逻辑。
安装对应语言的调试扩展
这是前提，否则 launch.json 配置无效：
- Python：必须安装官方 Python 扩展（由 Microsoft 提供），它内置 debugpy 调试器，无需额外 pip install debugpy（除非你用远程或特殊环境）
- Node.js：VS Code 内置 Node.js 调试支持，但建议同时安装 Node.js Extension Pack，含 ESLint、npm 等辅助工具
生成并编辑 launch.json 配置文件
在项目根目录下操作，不是用户全局设置：
- 打开命令面板（Cmd+Shift+P），输入 Debug: Open launch.json
- 选择环境：Python 或 Node.js，VS Code 自动生成基础模板
- 关键字段要核对：
-
type：必须是
python或node -
request：选
launch（启动新进程）或attach（附加到已有进程） -
program：指向实际入口文件，比如
"${workspaceFolder}/app.py"或"${workspaceFolder}/index.js" -
console：推荐设为
"integratedTerminal"，方便看日志和交互
-
type：必须是
针对常见场景调整配置
模板只是起点，真实项目常需补充：
-
Python 带参数运行：在配置里加
"args": ["--port", "8000", "--debug"] -
Node.js 使用 npm script（如 nodemon）：把
"runtimeExecutable": "npm"和"runtimeArgs": ["run", "dev"]加进去 -
调试 TypeScript：确保已编译出 .js 文件，并设
"sourceMaps": true和"outFiles": ["${workspaceFolder}/dist/**/*.js"] -
Flask/FastAPI：不用
program，改用"module": "flask"或"module": "uvicorn"，再配"args"如["app:app", "--reload"]
启动调试与验证
配置完别急着写代码，先验证是否生效：
立即学习“Python免费学习笔记（深入）”；
- 打开要调试的文件，在行号左侧单击设断点（红点出现即生效）
- 按 F5 或点击调试面板顶部绿色三角形
- 观察底部状态栏是否显示调试配置名，终端是否输出启动日志
- 如果报错 “Cannot connect to runtime process”，检查：
- Python 是否选对解释器（Cmd+Shift+P → Python: Select Interpreter）
- Node.js 是否已全局安装（
node -v可执行） - launch.json 中路径是否拼写正确（尤其注意 macOS 大小写敏感）
