VSC Remote Server识别Python模块但运行时报找不到模块异常

• PYTHONPATH未正确加载：
  VSC Remote Server启动的终端可能未读取.bashrc（比如非交互式/非登录shell场景）。可以在运行代码的终端执行echo $PYTHONPATH，确认目标目录是否在输出结果中。如果不在，可将PYTHONPATH配置移至~/.profile或~/.bash_profile（登录shell会加载这类文件），或者在VSC设置里配置终端启动命令强制读取.bashrc。

• 虚拟环境冲突：
  如果代码运行时使用了虚拟环境，全局的PYTHONPATH配置不会生效。此时需要把目标目录添加到虚拟环境的site-packages目录中（比如创建一个.pth文件，内容为目标目录的绝对路径），或者在虚拟环境的激活脚本里追加PYTHONPATH配置。

• 目录路径错误：
  确认.bashrc中添加的是绝对路径，相对路径在不同工作目录下会失效。正确写法示例：export PYTHONPATH="/home/user/your-target-dir:$PYTHONPATH"，而非./your-target-dir这类相对路径。

• VSC语言服务与运行环境不一致：
  VSC的语法高亮依赖Python语言服务（如Pylance）识别的路径，但实际运行代码用的可能是另一个Python解释器。可以查看VSC左下角选中的Python解释器，和终端中which python的输出是否一致。

• 缓存或进程未彻底重启：
  即使重启了VSC，语言服务的缓存可能未清除。可以按Ctrl+Shift+P输入Python: Restart Language Server重启服务，或者完全重启VSC Remote会话。

如果以上排查都未解决问题，需要补充以下信息：

• 终端执行echo $PYTHONPATH的输出内容
• 代码中导入语句的具体写法（比如import module_name还是from package import module）
• 目标目录的结构（是否包含__init__.py，目录层级关系）
• 代码的运行方式（VSC的「运行和调试」、终端直接执行python script.py、或其他方式）
• 完整的ModuleNotFoundError报错信息

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