VSCode使用.env配置自定义PYTHONPATH时Intellisense和PyLint失效问题

现有配置的错误点 #

• .env 中 PYTHONPATH 配置错误：你填写的相对路径 python 会以当前打开的工作区根路径（D:\code\Util）为基准拼接，实际指向的是不存在的 D:\code\Util\python，和你实际的包父路径 D:\code\python 不符。
• 仅配置全局 python.envFile 无法覆盖所有工具的路径识别逻辑：PyLint、Pylance 等代码检查、语言服务工具需要单独配置额外的导入搜索路径，不会自动读取 PYTHONPATH 做全场景适配。
• 若配置后未重载VSCode窗口，新的环境变量和配置不会生效。

修复步骤 #

第一步：修正.env配置 #

将 D:\code\.env 的内容修改为如下，使用绝对路径并保留原有系统PYTHONPATH：

PYTHONPATH=D:/code/python;${PYTHONPATH}

第二步：配置代码工具的额外搜索路径 #

任选以下一种方案即可：

方案A：修改VSCode配置（全局/工作区均可）

你可以直接在现有全局 settings.json 中追加以下内容，也可以在当前工作区新建 .vscode/settings.json 写入配置：

{
    "security.workspace.trust.untrustedFiles": "open",
    "python.envFile": "D:/code/.env",
    // Pylance 自动补全、类型检查用的额外搜索路径
    "python.analysis.extraPaths": [
        "D:/code/python"
    ],
    // PyLint 代码检查用的额外搜索路径
    "python.linting.pylintArgs": [
        "--init-hook",
        "import sys; sys.path.append('D:/code/python')"
    ]
}

方案B：添加语言服务配置文件

在 D:\code\python 目录下新建 pyrightconfig.json 文件，写入以下内容即可适配Pylance的路径识别：

{
    "extraPaths": ["D:/code/python"]
}

第三步：重载配置生效 #

按 Ctrl+Shift+P 调出VSCode命令面板，输入「重载窗口」（Reload Window）执行，重启语言服务后配置即可生效，导入波浪线和自动补全问题都会解决。

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