VS Code调试Python脚本报错：需macOS 11(1107)+，当前为11(1106)

环境与现象 #

• Pyenv当前指定Python版本为3.10.12（由/Users/scason/.python-version配置）
• 脚本依赖Tkinter库，核心代码如下：

#!/usr/bin/env python3
import random
##
from tkinter import *
from tkinter import ttk
from tkinter import messagebox


def genPW ():
    root = Tk()    # 此处调试时触发报错

    root.mainloop()


def main() :
    genPW()

if __name__ == '__main__':
    main ()

• 脚本可正常运行，在Eclipse的Python视角下也能正常调试，但VS Code调试时在root = Tk()位置触发报错
• 已尝试切换Pyenv管理的不同Python版本，问题未解决

解决方案 #

1. 确认VS Code选中正确的Python解释器 #

• 按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），输入Python: Select Interpreter
• 选择Pyenv管理的Python 3.10.12（路径通常为/Users/scason/.pyenv/versions/3.10.12/bin/python）
• 若列表中无该选项，选择Enter interpreter path手动粘贴上述路径

2. 配置VS Code调试文件（launch.json） #

• 打开调试面板，点击"创建launch.json文件"并选择Python环境
• 修改配置中的解释器路径，示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "python": "/Users/scason/.pyenv/versions/3.10.12/bin/python"
        }
    ]
}

注：旧版VS Code可能使用pythonPath字段替代python，按实际情况调整

3. 关闭"仅调试我的代码"选项 #

• 打开VS Code设置（Cmd+,/Ctrl+,），搜索Debug Just My Code
• 找到Python > Debugger: Just My Code，取消勾选
• 该选项默认会跳过标准库代码调试，Tk初始化属于标准库逻辑，关闭后可避免调试时触发无关报错

4. 验证Pyenv版本中Tkinter的完整性 #

• 终端执行pyenv local 3.10.12切换到目标版本
• 运行python -c "import tkinter; tkinter._test()"，若弹出测试窗口则Tkinter正常
• 若无法运行，需重新编译安装带Tkinter的Python版本：

pyenv uninstall 3.10.12
# Mac下先安装依赖：brew install tcl-tk
env PYTHON_CONFIGURE_OPTS="--with-tcltk-includes='-I/usr/local/opt/tcl-tk/include' --with-tcltk-libs='-L/usr/local/opt/tcl-tk/lib -ltcl8.6 -ltk8.6'" pyenv install 3.10.12

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