Ubuntu下VSCode运行Python报模块缺失、扩展路径异常如何修复

你遇到的问题来自几个新手常见的配置错误，和系统PATH关系不大：

• VSCode扩展面板安装的matplotlib、tensorflow是编辑器辅助插件，仅提供语法高亮、补全提示功能，不包含可被Python调用的实际依赖代码。这类插件安装后只会消除编辑区的语法波浪线，完全无法解决运行时的模块缺失报错。
• 当前VSCode运行代码使用的Python解释器，和你执行pip安装依赖对应的Python环境不匹配，是ModuleNotFoundError类报错的最常见诱因。
• 你之前手动添加的配置存在错误：
  • 临时执行的PATH=$PATH:$HOME/home/joshua/.local/bin路径拼接错误，$HOME本身对应用户主目录/home/joshua，拼接后的路径为不存在的/home/joshua/home/joshua/.local/bin，且该配置仅对当前终端临时生效，关闭后自动失效。
  • python.analysis.stubPath参数用于指定Python类型存根文件目录，填入bin可执行文件路径属于配置错误，该参数保持默认值即可。
• 当前主流Keras版本默认以TensorFlow为后端，仅安装keras不安装匹配版本的tensorflow，导入时必然触发找不到tensorflow的报错。

1. 清理错误配置 #

打开VSCode的settings.json配置文件，删除你之前手动添加的两段错误配置：

• 删除terminal.integrated.env.linux下手动添加的PATH规则，Ubuntu 20.04及之后的版本会自动将~/.local/bin加入PATH，无需手动配置。
• 删除错误的"python.analysis.stubPath": "/home/joshua/.local/bin"配置项。

2. 选中正确的Python解释器 #

• 打开你的model_dev.ipynb文件，点击VSCode右上角显示Python版本的按钮，在弹出的解释器列表中选择当前用户目录下的Python解释器，路径一般为/home/joshua/.local/bin/python3或系统自带的/usr/bin/python3，不要选临时虚拟环境、未安装过依赖的conda环境。
• 选中后新建VSCode内置终端（快捷键Ctrl+`` ），执行命令python3 -m pip --version，确认输出的pip路径和你选中的解释器路径匹配：如果输出中pip对应的site-packages路径在/home/joshua/.local/lib/python3.x/下，说明解释器选择正确。

3. 在对应环境安装依赖 #

永远使用python3 -m pip的方式安装包，不要直接输入pip，避免将包装到不对应的Python环境中
在刚才打开的内置终端依次执行以下命令：

# 先清理可能装错位置的旧包
python3 -m pip uninstall -y keras numpy matplotlib tensorflow
# 升级pip到最新版本
python3 -m pip install --upgrade pip
# 安装全部所需依赖，安装keras时会自动拉取匹配版本的tensorflow
python3 -m pip install tensorflow numpy matplotlib keras

安装过程如果出现权限不足提示，在install后加--user参数即可，比如python3 -m pip install --user tensorflow，不要加sudo执行pip安装，避免破坏系统自带Python的依赖。

安装完成后执行验证命令：

python3 -c "import tensorflow, numpy, matplotlib, keras; print('依赖校验通过')"

如果终端输出依赖校验通过，说明运行环境依赖已经安装正确。

4. 重启运行环境 #

回到notebook页面，点击顶部工具栏的重启内核按钮（圆形箭头图标），重新运行代码单元格即可。

• 如果编辑区Pylance仍然提示"cannot be resolved"，按快捷键Ctrl+Shift+P调出命令面板，输入Python: Restart Language Server执行，等待10秒左右即可自动识别已安装的包。
• 新手阶段不要随意修改系统PATH配置、不要混用pip/pip3指令，只要保证选对解释器、用python3 -m pip装包，基本不会再出现模块找不到的问题。

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