使用Hatch时VS Code的Pylance无法解析导入，如何指定解释器？

核心原因 #

VS Code默认使用全局Python解释器，而Hatch创建的虚拟环境不在项目目录内，导致Pylance找不到依赖包。

步骤1：获取Hatch环境的Python解释器路径 #

执行以下命令查看默认环境的解释器路径：

hatch env find default

会输出对应系统的路径：

• Windows：C:\Users\你的用户名\AppData\Local\hatch\你的项目名\default\Scripts\python.exe
• Linux/macOS：~/.local/share/hatch/env/virtual/你的项目名/default/bin/python

步骤2：配置VS Code使用该解释器 #

有两种操作方式：

• 手动选择：点击VS Code左下角状态栏的Python版本，在弹出列表中选择「Enter interpreter path」，粘贴刚才获取的路径并确认。
• 配置settings.json：在项目根目录创建.vscode/settings.json文件，添加以下内容（替换为你的实际路径）：

{
  "python.defaultInterpreterPath": "C:\\Users\\你的用户名\\AppData\\Local\\hatch\\你的项目名\\default\\Scripts\\python.exe"
}

步骤3：（可选）让Hatch将环境存到项目目录内 #

如果希望环境保存在项目的.hatch文件夹中，修改pyproject.toml添加以下配置：

[tool.hatch.envs]
virtual = { location = ".hatch" }

然后执行命令重建环境：

hatch env prune
hatch env create default

再次执行hatch env find default，路径会变为项目目录下的.hatch/default/.../python.exe，之后在VS Code选择这个路径即可。

完成以上操作后，重启VS Code，Pylance的导入错误提示会消失。

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