VSCode中Pylance无法识别可编辑模式安装的ligpargen模块

• 检查项目结构是否符合Python包规范
  可编辑安装后Pylance识别不了但交互模式能导入，大概率是项目结构没遵循Python包要求。确认你的源码目录结构是这样的：

  /path/to/ligpargen/
  ├── ligpargen/
  │   ├── __init__.py  # 必须存在，空文件也可以
  │   └── （你的模块代码文件）
  ├── pyproject.toml 或 setup.py/setup.cfg
  └── LigPargen-2.1.dist-info/
  

  同时检查pyproject.toml（或setup.py）里的包配置，比如在pyproject.toml中应该有类似：

  [tool.setuptools.packages.find]
  where = ["."]
  

  或者setup.py里：

  setup(
      name="LigPargen",
      packages=["ligpargen"],
      # 其他配置...
  )
  

• 重新执行可编辑安装
  先清理现有安装残留，再重新安装：

  1. 卸载现有版本：

     pip uninstall -y ligpargen
     

  2. 删除安装目录下的LigPargen-2.1.dist-info文件夹，以及项目根目录的__pycache__、.eggs缓存文件夹
  3. 重新执行可编辑安装（暂时去掉editable_mode=strict，部分pip版本对这个参数支持有问题）：

     pip install -e .
     

• 手动配置Pylance的额外搜索路径
  如果上述步骤无效，直接给Pylance指定模块位置：

  1. 打开VS Code设置（快捷键Ctrl+,）
  2. 搜索Python > Analysis: Extra Paths
  3. 添加你的ligpargen源码根目录路径：/path/to/ligpargen
  4. 执行Ctrl+Shift+P选择「重新加载窗口」，让配置生效

• 确认VS Code使用的虚拟环境正确
  检查VS Code右下角显示的Python解释器路径，和你交互模式中运行which python（Linux/macOS）或where python（Windows）输出的路径是否完全一致，确保Pylance使用的是同一个虚拟环境。

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