从平行目录导入Python模块遇ModuleNotFoundError，PyCharm正常VS Code异常

以下是PyCharm正常运行但VS Code报错ModuleNotFoundError的常见原因和对应解决步骤：

• Python解释器不匹配
  PyCharm和VS Code大概率用了不同的Python环境（比如全局Python、虚拟环境或者不同版本的Python）。解决方法：点击VS Code右下角显示的Python版本号，在弹出的列表里选择和PyCharm完全一致的解释器。

• 项目根目录未加入Python路径
  PyCharm会自动把项目根目录添加到Python的搜索路径里，但VS Code有时候不会自动做这件事。

  • 临时方案：在导入模块的代码前添加路径配置：

    import sys
    from pathlib import Path
    # 根据你的模块实际位置调整层级，比如模块在项目根目录下就用parent，在子目录则调整为parent.parent
    sys.path.append(str(Path(__file__).parent))
    

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

    PYTHONPATH=${PYTHONPATH}:${PROJECT_DIR}
    

    保存后重启VS Code，确保已经安装并启用了官方的Python插件。

• 虚拟环境未激活
  如果你的项目用了虚拟环境，PyCharm启动时会自动激活，但VS Code的终端可能没自动激活。解决方法：打开VS Code的终端，手动激活虚拟环境——Windows下执行venv\Scripts\activate，Linux/macOS下执行source venv/bin/activate。

• 模块路径或命名问题
  检查模块文件名的拼写和大小写（Linux/macOS系统下文件名大小写敏感，PyCharm可能自动忽略了大小写差异，但VS Code会严格区分）；另外如果模块在子目录里，确认该目录下是否有__init__.py文件（Python 3.3+虽然不需要，但部分场景下还是需要这个文件来标识包）。

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