macOS Monterey系统下VSCode运行Python首次出现终端异常求助

前置环境校验 #

• 确认本地Python安装正常：打开系统自带终端，执行python --version（Windows）或python3 --version（Mac/Linux），能正常输出版本号则说明安装成功。如果安装时未勾选Add Python to PATH，需要重新运行安装包修复，或手动配置Python路径到系统环境变量。
• 确认VSCode已安装官方Python扩展：打开VSCode扩展商店，搜索Python，找到微软官方发布的扩展安装后重启VSCode。

解释器关联配置 #

这是新手首次运行Python项目最常见的问题触发点：

• 必须在VSCode中打开你的Python项目根文件夹，不要单独打开单个.py文件。
• 按下快捷键Ctrl+Shift+P（Mac系统为Cmd+Shift+P）调出命令面板，输入Python: Select Interpreter。
• 在弹出的解释器列表中，选择你已经安装的对应Python版本，不要选择未知的虚拟环境路径（如果未自行创建过虚拟环境的前提下）。
• 关闭VSCode当前已打开的所有终端面板，重新运行你的.py文件测试。

模块缺失问题处理 #

如果运行报错包含ModuleNotFoundError关键词，说明你调用的第三方依赖未安装：

• 打开VSCode当前项目的终端面板，执行pip install 对应模块名（Windows）或pip3 install 对应模块名（Mac/Linux）。
• 依赖安装完成后重新运行代码即可。

代码语法问题排查 #

如果报错指向具体代码行，优先检查对应位置：

• 缩进统一使用4个空格，禁止Tab和空格混用。
• 确认所有括号、引号成对闭合，没有遗漏。
• 确认Python关键字、内置函数没有拼写错误，比如不要把print误写为printf。

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