如何让Pylance在独立目录下为代码提供完整导入建议？

问题场景 #

当满足以下条件时，VSCode的Pylance会缺失大量导入建议：

• 包以可编辑模式本地安装（pip install -e .）
• 代码工作目录与包的源码目录相互独立
• 目标包是无顶层__init__.py的命名空间包

示例复现 #

1. 在C:/work目录克隆并可编辑安装python-dotenv：

cd C:/work
git clone https://github.com/theskumar/python-dotenv
pip install -e .

2. 在包源码目录C:/work/python-dotenv内编写代码时，Pylance能正常提供所有导入建议；但切换到独立目录C:/work/scripts编写代码时：

x = get_cli_string()
x = with_warn_for_invalid_lines()

即使已配置Python > Analysis > Package Index Depths，Pylance仍仅识别顶层导入，且因命名空间包不允许存在顶层__init__.py，无法通过配置__all__导出成员来解决。

解决方案 #

1. 确认Python解释器环境 #

确保VSCode使用的Python解释器是安装了该可编辑包的环境：

• 点击VSCode右下角的Python版本号，选择对应环境。

2. 添加包源码路径到分析额外路径 #

在VSCode的settings.json中配置python.analysis.extraPaths，直接指向包的源码根目录，让Pylance能扫描到所有模块：

{
    "python.analysis.extraPaths": [
        "C:/work/python-dotenv"
    ]
}

3. 针对性配置包索引深度 #

调整python.analysis.packageIndexDepths，为目标包设置足够大的扫描深度（比如设为2或更高，根据包的结构调整）：

{
    "python.analysis.packageIndexDepths": [
        {
            "name": "python-dotenv",
            "depth": 2
        }
    ]
}

4. 生效配置 #

保存settings.json后，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行Reload Window命令，让配置生效。

完成以上步骤后，Pylance就能像在包源码目录内工作时一样，提供完整的导入建议和快速修复选项。

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