如何修复已安装Python但Visual Studio Code仍无法识别的问题

1. 清理系统冗余安装残留 #

• 卸载所有未完成安装的Python版本：Windows系统进入「控制面板-程序-卸载程序」，找到所有带Python标识的未完成安装项全部卸载；macOS/Linux系统执行sudo rm -rf /Library/Frameworks/Python.framework/Versions/x.x（x.x对应要删除的版本号），同时清理用户目录下~/.local/lib下的对应Python残留文件夹
• 卸载未完成的Anaconda安装：Windows直接在卸载程序里找到Anaconda相关项卸载；macOS/Linux执行rm -rf ~/anaconda3，同时删除.bashrc/.zshrc/.bash_profile配置文件中所有Anaconda相关的环境变量行
• 清理系统环境变量：打开系统环境变量编辑面板，删除所有和已卸载Python、Anaconda相关的Path路径，避免后续识别冲突

2. 安装正式版本（二选一即可，避免多版本冲突） #

• 方案A：仅使用官方Python：下载对应系统的Python稳定版安装包，安装时勾选Add Python x.x to PATH选项，选择默认路径完成全部安装流程
• 方案B：使用Anaconda：下载对应系统的Anaconda完整安装包，安装时勾选Add Anaconda to my PATH environment variable选项，等待安装完全结束再进行后续操作

3. 修复SSL报错问题 #

安装完成后先在终端执行pip -V验证功能，如果仍然报Can't connect to HTTPS URL because the SSL module is not available.错误，按对应系统操作：

• Windows：将Python安装目录下的DLLs、Library/bin两个路径添加到系统Path变量，重启终端后重试
• macOS/Linux：先安装openssl依赖（macOS执行brew install openssl，Linux执行对应发行版的openssl安装命令，如Ubuntu的sudo apt install openssl libssl-dev），重新安装Python即可修复SSL缺失问题

4. 配置VS Code识别.py文件 #

• 打开VS Code，搜索并安装Microsoft官方发布的Python扩展
• 打开任意.py文件，点击VS Code右下角的Python版本选择按钮，选择你刚安装完成的正式Python/Anaconda Python解释器路径
• 若仍无法识别，按Ctrl+Shift+P（macOS为Cmd+Shift+P）调出命令面板，输入「Python: Select Interpreter」，手动选择对应解释器即可

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