MacOS Sequoia更新后，如何配置VS Code调试Python（含pipx场景）

一、基础调试配置（针对brew安装的Python） #

• 先确认VS Code里的官方Python插件已安装：打开扩展商店搜「Python」，找微软官方的那个，确保启用状态。
• 指定brew安装的Python解释器：
  1. 按下Cmd+Shift+P（Mac快捷键），输入Python: Select Interpreter。
  2. 在列表里找brew安装的Python 3.12.6路径——Intel Mac一般是/usr/local/bin/python3，Apple Silicon是/opt/homebrew/bin/python3，选中即可。
• 创建调试配置文件：
  1. 打开要调试的Python文件，点左侧的虫子图标（调试栏），再点「创建launch.json文件」。
  2. 选「Python」环境，VS Code会自动生成基础配置，你可以按需修改，比如指定解释器路径、添加运行参数：

     {
         "version": "0.2.0",
         "configurations": [
             {
                 "name": "Python: 当前文件",
                 "type": "python",
                 "request": "launch",
                 "program": "${file}",
                 "console": "integratedTerminal",
                 "python": "/opt/homebrew/bin/python3" // 替换成你的brew Python实际路径
             }
         ]
     }
     

• 启动调试：打开目标文件，点调试栏的绿色播放键，或者按F5，就能正常用断点、查看变量这些功能了。

二、pipx环境下的Python代码调试方法 #

pipx的包都隔离在单独虚拟环境里，调试得先找到对应环境的解释器：

• 找pipx包的虚拟环境路径：
  跑命令pipx list，找到要调试的包，它的虚拟环境路径一般是~/.local/pipx/venvs/[包名]，比如~/.local/pipx/venvs/pytest。
• 在VS Code里指定该环境的解释器：
  按下Cmd+Shift+P，输入Python: Select Interpreter，选「Enter interpreter path...」，粘贴虚拟环境里的Python路径，比如~/.local/pipx/venvs/[包名]/bin/python。
• 调整调试配置：
  如果调试的是pipx包的入口脚本，直接在launch.json里指定程序路径和参数就行。比如调试pipx安装的pytest：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: pipx包调试",
              "type": "python",
              "request": "launch",
              "program": "~/.local/pipx/venvs/pytest/bin/pytest",
              "args": ["test_sample.py"], // 替换成你的调试参数
              "console": "integratedTerminal",
              "python": "~/.local/pipx/venvs/pytest/bin/python"
          }
      ]
  }
  

• 调试包源码：如果要调包的源码，把虚拟环境下lib/python3.12/site-packages/[包名]目录添加到VS Code工作区，在源码里打个断点，启动调试就可以了。

内容的提问来源于stack exchange，提问作者JGFMK