VSCode运行调试Flask服务反复提示Unable to find python module

问题现象 #

在VSCode中运行或调试简单Flask服务时，反复收到提示：

Unable to find python module.

服务可正常启动，但提示持续出现，相关环境信息如下：

• Python版本：3.9.10（路径/c/msys64/mingw64/bin/python）
• Flask版本：2.2.3
• VSCode Python插件版本：2023.4.1

排查与解决步骤 #

1. 确认VSCode的Python解释器配置 #

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Python: Select Interpreter
• 选择对应路径的MSYS2 Python解释器，避免VSCode因选错解释器导致模块查找失败

2. 检查Flask运行/调试配置正确性 #

• 打开项目下的.vscode/launch.json文件，确认配置参数准确，示例正确配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Flask",
            "type": "python",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "app.py",
                "FLASK_ENV": "development"
            },
            "args": [
                "run",
                "--no-debugger",
                "--no-reload"
            ],
            "jinja": true
        }
    ]
}

• 确保FLASK_APP指向正确的应用入口文件（如你的app.py），路径无拼写错误

3. 修复MSYS2环境与VSCode的路径兼容性 #

由于使用MSYS2的Python，VSCode可能存在路径解析问题：

• 尝试切换到Windows原生CMD或PowerShell终端运行Flask服务，观察提示是否消失
• 若需保留MINGW64终端，可在VSCode的settings.json中添加如下配置，确保环境变量正确传递：

"terminal.integrated.profiles.windows": {
    "MINGW64": {
        "path": "C:\\msys64\\usr\\bin\\bash.exe",
        "args": ["--login"],
        "env": {
            "PATH": "${env:PATH}:C:\\msys64\\mingw64\\bin"
        }
    }
},
"terminal.integrated.defaultProfile.windows": "MINGW64"

4. 更新VSCode Python插件 #

当前使用的Python插件版本较旧，更新到最新版本可修复已知的模块查找bug：

• 打开VSCode扩展面板，找到Python插件点击更新，重启VSCode后再测试

5. 验证并修复Python模块搜索路径 #

在VSCode终端运行以下命令，查看Python的模块搜索路径：

python -c "import sys; print('\n'.join(sys.path))"

若Flask的安装路径不在输出结果中，可通过以下方式添加：

• 在项目根目录创建.env文件，写入：

PYTHONPATH=/c/msys64/mingw64/lib/python3.9/site-packages

替换为你的实际site-packages路径，重启VSCode即可

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