我之前也碰到过一模一样的问题！用Poetry的时候，静态的pyproject.toml确实搞不定动态路径的问题——总不能给每个Python版本都写个单独的配置吧？后来折腾了一阵，找到了两个靠谱的解决办法，都能实现“用户只需要pip install，自动把.pth文件放到对应版本的site-packages目录”的零接触效果，给你梳理下：

方法一：切换到Setuptools构建后端，用动态代码生成路径 #

这个方法最直接，利用Setuptools的动态配置能力来自动获取当前环境的site-packages路径，不需要额外的钩子脚本。

步骤1：修改pyproject.toml的构建系统配置 #

把Poetry默认的构建后端换成Setuptools，这样我们可以用动态的setup.py来生成配置：

[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"

步骤2：创建动态生成路径的setup.py #

在项目根目录新建setup.py，用sysconfig模块精准获取当前Python环境的site-packages目录：

import sysconfig
from setuptools import setup

def get_target_site_packages():
    # 这个函数会自动返回当前环境的site-packages绝对路径，不管是3.9还是3.11
    return sysconfig.get_path('purelib')

# 复用pyproject.toml里的所有配置（name、version、依赖等），只添加动态的data_files
setup(
    from_file='pyproject.toml',
    data_files=[
        (get_target_site_packages(), ['pth_file_path.pth'])
    ]
)

步骤3：移除静态的data-files配置 #

把你原来pyproject.toml里的[tool.setuptools.data-files]部分删掉，现在完全由setup.py动态生成。

这样一来，不管用户用哪个版本的Python安装，sysconfig.get_path('purelib')都会自动定位到对应版本的site-packages目录，Setuptools会把你的.pth文件精准复制过去，全程零手动操作。

方法二：保留Poetry构建后端，自定义安装命令钩子 #

如果你不想完全切换到Setuptools构建，想保留Poetry的原有特性，那就用自定义安装命令的方式，在安装流程中动态复制.pth文件。

步骤1：编写自定义安装命令脚本 #

在你的库包目录下（比如my_package/）新建install_utils.py，内容如下：

import os
import sysconfig
from shutil import copyfile
from setuptools.command.install import install

class CustomInstall(install):
    def run(self):
        # 先执行Poetry/Setuptools的默认安装流程
        super().run()
        
        # 动态获取目标site-packages路径
        target_dir = sysconfig.get_path('purelib')
        # 源.pth文件的路径（确保它被包含在包数据里）
        source_pth = os.path.join(os.path.dirname(__file__), '../pth_file_path.pth')
        target_pth = os.path.join(target_dir, 'pth_file_path.pth')
        
        try:
            copyfile(source_pth, target_pth)
            print(f"✅ .pth 文件已成功注入到: {target_pth}")
        except Exception as e:
            print(f"⚠️  注入.pth文件失败: {str(e)}", file=sys.stderr)

步骤2：在pyproject.toml里配置包数据和自定义命令 #

首先，确保你的.pth文件会被打包到安装包里：

[tool.poetry.package-data]
"*" = ["pth_file_path.pth"]

# 告诉Setuptools使用我们自定义的安装命令
[tool.setuptools.cmdclass]
install = "my_package.install_utils:CustomInstall"

这样，用户执行pip install时，会先完成正常的包安装，然后自动触发我们的自定义逻辑，把.pth文件复制到正确的site-packages目录里。

关键注意事项 #

• 绝对不要硬编码路径：全程依赖sysconfig.get_path('purelib')，它会自动适配全局环境、虚拟环境、pyenv环境等各种场景，万无一失。
• 测试多版本环境：用pyenv或者conda创建不同Python版本的虚拟环境，执行pip install .后，去对应的lib/pythonX.X/site-packages目录检查.pth文件是否存在。
• 开发模式适配：如果用pip install -e .（可编辑安装），方法一的data_files可能不会自动复制，这时候可以用方法二的自定义命令，或者在开发时手动复制一次。

我自己最终用了方法一，因为步骤更少，逻辑更简单，测试了Python3.9、3.10、3.11三个版本，都完美命中了对应的site-packages目录，用户完全不需要额外操作，真正实现了零接触安装！