如何让Poetry正确识别本地依赖并遵循PYTHONPATH？

下面提供几种实用方案，既能让Poetry虚拟环境识别到你自定义site-packages里的包，又能保持虚拟环境与系统的高度隔离：

方案1：临时设置PYTHONPATH（快速验证用） #

激活当前项目的Poetry虚拟环境后，在终端里直接指定PYTHONPATH指向你的自定义site-packages目录：

# Linux/macOS
export PYTHONPATH="/path/to/your/custom/site-packages:$PYTHONPATH"

# Windows cmd
set PYTHONPATH=C:\path\to\your\custom\site-packages;%PYTHONPATH%

这个设置仅在当前终端会话有效，退出后自动失效，不会对虚拟环境的隔离性造成永久影响。

方案2：用.env文件持久化PYTHONPATH（长期使用） #

在第二个项目的根目录创建.env文件，写入以下内容：

PYTHONPATH="/path/to/your/custom/site-packages:$PYTHONPATH"

Poetry 1.2及以上版本默认支持自动加载项目根目录的.env文件。如果是旧版本，需要先安装python-dotenv依赖：

poetry add --dev python-dotenv

之后用poetry run启动的所有命令都会自动加载这个PYTHONPATH配置，既不用每次手动设置，又只作用于当前项目的虚拟环境，完全不影响系统或其他项目。

方案3：将第一个包作为开发依赖引入（推荐的Poetry工作流） #

如果第一个包还处于开发阶段，更推荐直接把它作为本地可编辑依赖添加到第二个项目：

poetry add --editable /path/to/your/first/package

这样Poetry会在虚拟环境中创建一个指向第一个包源码的软链接，既能实时获取第一个包的代码更新，又完全脱离对系统site-packages的依赖，完美保持虚拟环境的隔离性，这也是Poetry官方推荐的跨项目开发方式。

方案说明 #

前两种方法通过精准添加指定目录到PYTHONPATH，仅让虚拟环境识别你需要的那个自定义包所在的目录，不会导入整个系统site-packages，因此能保持venv的高度隔离；第三种方法则完全贴合Poetry的依赖管理逻辑，从根源上避免了对系统环境的依赖，是长期开发的最优选择。

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