VS Code同文件夹下文件使用不同Python版本问题求助

架构老林

2026-6-27

解决方案

确认VS Code工作区解释器
点击VS Code左下角状态栏的Python版本标识，检查当前选中的是否为3.10.10。如果不是，点击选择并定位到该版本的安装路径（例如C:\Python310\python.exe），确保整个工作区统一使用目标解释器。

检查调试配置文件
若通过调试模式运行主文件，打开.vscode/launch.json，确认python字段（旧版本可能是pythonPath）指向3.10.10的解释器路径。示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "python": "C:/Python310/python.exe",
            "console": "integratedTerminal"
        }
    ]
}

避免为子文件夹单独配置不同的解释器规则。

排查子文件夹虚拟环境
检查子文件夹下是否存在venv或env这类虚拟环境目录。如果有，要么删除该虚拟环境并统一使用基于3.10.10创建的虚拟环境，要么在VS Code中切换到该虚拟环境的python.exe（例如./venv/Scripts/python.exe）。
清理shebang行（跨平台场景）
打开被引用的子文件夹文件，查看顶部是否存在类似#!/usr/bin/env python3.9的shebang声明。如果有，直接删除该行，或者修改为#!/usr/bin/env python3.10，避免强制指定旧版本解释器。
调整系统环境变量优先级
打开系统环境变量设置，将3.10.10的Python安装路径移到PATH列表的最顶端，确保系统优先调用目标版本。修改后重启VS Code生效。
直接用绝对路径运行主文件
在终端中直接指定3.10.10的解释器路径运行主文件，例如：
```
C:\Python310\python.exe path/to/your/main.py
```
这种方式可以绕开VS Code的自动配置，验证版本不一致问题是否由配置错误导致。