如何配置VSCode使Python自动导入带指定包名前缀？

以下是几种可行的方法，帮你让Pylance生成带mypackage前缀的绝对导入语句：

1. 调整VSCode工作区根目录 #

如果你的VSCode当前打开的是mypackage目录本身，直接切换到mypackage的上层目录作为工作区根目录。这样Pylance会自动将mypackage识别为顶层包，后续自动导入就会生成from mypackage.mydirectory.myfile import myclass格式的语句。

2. 配置Pylance分析根路径 #

不想改工作区目录的话，在项目的.vscode/settings.json中添加以下配置，强制Pylance将mypackage的上层目录纳入分析范围：

{
    "python.analysis.root": "${workspaceFolder}/.."
}

或者通过添加额外路径实现：

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

配置完成后，重启VSCode或执行「开发者: 重新加载窗口」让设置生效。

3. 用pyproject.toml定义包结构 #

如果你的项目使用现代Python项目规范，在项目根目录（mypackage的上层目录）创建或修改pyproject.toml，添加Pylance的根目录配置：

[tool.pylance]
root = "."

这会明确告诉Pylance当前目录是包结构的顶层，确保mypackage被作为根包识别。

4. 确认包的结构规范 #

确保mypackage/和mydirectory/目录下都存在空的__init__.py文件，这是Python识别包层级的必要条件，也能帮助Pylance正确解析你的包结构。

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