已安装Editable模块，VSCode交互窗口仍报ModuleNotFoundError

环境配置 #

• 使用Miniconda 3管理Python环境，通过environment.yaml配置
• 用于VSCode开发，环境通过conda安装第三方包后，以可编辑模式安装本地开发包，简化版配置如下：

name: DLL_ETL
channels:
  - conda-forge
  - msys2
  - defaults
dependencies:
  - pandas
  - numpy

  - pip:
    - -e .
    - datatable

• 定期通过mamba env update更新环境

出现的问题 #

• Pip提示包安装成功
• 环境命令行中运行Python可正常导入本地包
• 包已安装到OneDrive下的正确路径
• VSCode中以该环境为内核打开交互窗口时，提示找不到该包

已尝试的操作 #

• 删除环境并重新安装
• 删除__pycache__和dll.egg-info目录
• 手动通过pip卸载并重新安装（不通过mamba）
• 查看conda list确认包已正确安装

已确认事项 #

• 确实在使用指定的虚拟环境
• 操作时处于正确目录（更新yaml、手动安装时均是）
• 本地包目录已在Python路径中，命令行Python运行正常

排查与解决方法 #

1. 检查VSCode的Python解释器路径

   • 点击VSCode左下角的Python解释器选择框，确认选中的是DLL_ETL环境的Python可执行文件，路径示例：
     • Windows：C:\Users\<用户名>\miniconda3\envs\DLL_ETL\python.exe
     • Linux/macOS：~/miniconda3/envs/DLL_ETL/bin/python
   • 避免误选全局Python或其他虚拟环境。

2. 刷新VSCode语言服务缓存

   • 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Restart Language Server，重启语言服务后重新尝试导入包。

3. 排查OneDrive同步问题

   • 确认OneDrive已完成本地包目录的同步，无文件处于“正在同步”状态
   • 右键本地包所在文件夹，取消再重新勾选“始终保持在此设备上”，强制触发同步
   • 临时将本地包移至非OneDrive目录，以pip install -e .重新安装，测试VSCode是否能识别，排除OneDrive权限或同步延迟的影响。

4. 检查VSCode工作区设置

   • 打开.vscode/settings.json，确认python.analysis.extraPaths配置包含本地包的根目录，若缺失则添加：

     {
       "python.analysis.extraPaths": ["./"]
     }
     

   • 若本地包不在工作区根目录，替换为实际路径。

5. 对比环境路径一致性

   • 在环境命令行中执行：

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

   • 在VSCode交互窗口中执行同样命令，对比两者的路径列表。若VSCode中缺少本地包路径，可手动临时添加测试：

     import sys
     sys.path.append("你的本地包根目录路径")
     

   • 若添加后能正常导入，说明VSCode未正确加载环境路径，尝试重启VSCode或重新选择解释器。

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