D盘Python搭配VS Code与Git Bash 可运行但导入类报未定义错误咨询

出现“代码可通过Git Bash正常运行、悬停可看到类定义但导入标记报错、无语法高亮”的矛盾表现，本质是VS Code内置Python语言服务选用的解释器路径，和实际运行代码时使用的D盘Python路径存在错位，并非代码本身的运行错误。

第一步 强制匹配VS Code解释器与D盘实际Python路径 #

• 按下快捷键Ctrl+Shift+P调出全局命令面板，输入Python: Select Interpreter唤起解释器选择菜单
• 选择「Enter interpreter path」选项，手动定位到D盘安装目录下的python.exe可执行文件，典型路径格式为D:\Programs\Python311\python.exe
• 路径选择完成后，再次调出命令面板，执行Developer: Reload Window重载窗口让配置生效

第二步 修正语言服务配置，消除识别矛盾 #

• 确认Python语言服务的运行状态：通过命令面板打开Preferences: Open Settings (UI)，检索设置项Python > Language Server: Type，确保该选项选中为Pylance，不要设置为已停止维护的Jedi或None值
• 检查工作区配置：打开项目根目录下.vscode文件夹内的settings.json文件，移除文件内硬编码的错误Python路径，可参考如下配置写入正确路径：

  {
    "python.defaultInterpreterPath": "D:\\你的D盘Python安装路径\\python.exe",
    "python.analysis.diagnosticSeverityOverrides": {
      "reportMissingModuleSource": "none"
    }
  }
  

• 清空语言服务缓存（针对“能看到类定义但报未定义错误”的典型错位问题）：在命令面板执行Python: Clear Cache，清空当前项目的历史分析缓存后再次重载窗口

第三步 修复语法高亮失效问题 #

• 仅保留微软官方发布的Python基础扩展（扩展标识为ms-python.python），禁用所有非官方渠道安装的第三方Python语法、代码提示类扩展，避免多扩展规则冲突覆盖官方高亮逻辑
• 检查VS Code右下角的文件类型识别状态：若当前打开的.py文件被识别为其他格式（如纯文本、Markdown），点击右下角的语言标识，手动将文件类型切换为Python，对应语法高亮规则会自动加载

第四步 校验全路径一致性 #

• 在VS Code内置的Git Bash终端中执行命令which python，将输出的Git Bash格式路径（如/d/Programs/Python311/python.exe）转换为Windows系统格式，确认和你在VS Code解释器配置中填写的路径完全一致，避免出现“系统环境变量调用C盘默认Python、手动执行时调用D盘Python”的路径错位

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