Mac下VSCode python.pythonPath配置错误导致运行调试脚本报错怎么办

1. 修复Python解释器路径无效的报错 #

• 你当前设置里的python.pythonPath指向macOS自带的Python 2.7安装路径，这是调试时提示“Python路径无效”的直接原因。
• 替换步骤：
  • 打开VSCode的用户设置JSON，删除原有错误配置行：

    "python.pythonPath": "/System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python"
    

  • 填入你之前在终端通过print(sys.executable)获取的Python3路径，结合你给出的报错回溯日志，对应正确路径为/Library/Frameworks/Python.framework/Versions/3.9/bin/python3
  • 保存配置后，按Cmd+Shift+P调出命令面板，执行Python: Select Interpreter命令，选择刚才配置的Python3.9版本路径，完成解释器关联。

2. 处理终端zsh提示与密码验证报错 #

• 运行脚本时弹出的“默认交互shell已切换为zsh，请运行chsh -s /bin/zsh”是macOS的系统升级提示，和Python脚本运行流程完全无关，不需要执行给出的切换命令，也不需要输入账户密码。
• 你遇到的hsh: Credentials could not be verified报错，是误触发chsh命令的验证流程导致的：Mac终端输入账户密码时不会显示任何输入字符，很容易因为反复确认输入内容导致密码验证失败。
• 彻底关闭这个提示的方法：打开VSCode设置，搜索terminal.integrated.defaultProfile.osx，将值设置为你当前常用的shell路径（如/bin/bash），之后就不会再弹出要求切换shell、输入密码的冗余提示。

3. 修复debugpy连接被拒的报错 #

• 日志里的ConnectionRefusedError: [Errno 61]报错和外部网络、防火墙完全无关，是本地调试服务启动失败导致的：一方面你之前的解释器路径配置错误，另一方面你使用的Python扩展版本过老（2020.12版），和当前的Python3.9版本兼容不足，导致调试进程无法正常启动。
• 修复步骤：
  • 打开扩展管理面板，找到Python扩展，升级到最新稳定版
  • 升级完成后重启VSCode，重新运行测试脚本，调试模块会自动在本地回环地址启动服务，端口通信恢复正常，不会再出现连接被拒的问题。

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