如何自动处理Python包的非PyPi依赖：下载或预警？

一、自动搞定Psi4依赖的办法 #

因为Psi4仅在Conda仓库分发，pip本身无法直接从Conda源拉取包，要实现自动处理得借助额外工具或配置：

1. 用安装脚本自动检查安装 #

借助hatchling的钩子或自定义安装脚本，在用户安装你的包后自动检查并安装Psi4：

• 在pyproject.toml里配置hatchling的自定义钩子：

[tool.hatch.build.hooks.custom]
script = "scripts/check_psi4.py"

• 编写check_psi4.py脚本，检查系统是否有conda，再执行安装命令：

import subprocess
import sys

try:
    import psi4
except ImportError:
    # 检查conda是否可用
    try:
        subprocess.run(["conda", "--version"], check=True, capture_output=True)
        print("正在安装Psi4依赖...")
        subprocess.run(["conda", "install", "-c", "psi4", "psi4", "-y"], check=True)
    except (subprocess.CalledProcessError, FileNotFoundError):
        print("错误：未检测到conda，无法自动安装Psi4。请先安装conda，再执行`conda install -c psi4 psi4`", file=sys.stderr)
        sys.exit(1)

注意：该方法要求用户环境已安装conda，否则会报错，需在文档中明确说明。

2. 同时分发Conda包 #

既然Psi4在Conda仓库，你可以同时在Conda频道（如Conda Forge或自定义频道）分发你的包，在meta.yaml中直接声明依赖：

requirements:
  run:
    - python >=3.12
    - qiskit ==1.0.0
    - qiskit-nature >=0.5.1
    - numpy >=1.23.0
    - deprecated >=1.2.0
    - psi4

这样用户通过conda安装你的包时，会自动从psi4频道拉取依赖；PyPI版本则留给不需要Psi4的用户（若你的包支持部分功能不依赖Psi4）。

二、无法自动安装时的提醒方式 #

如果不想依赖conda或无法实现自动安装，可通过以下方式提前给用户预警：

1. 在配置文件和文档里明确标注 #

在pyproject.toml的依赖列表中添加注释（虽pip不识别，但能直观看到），同时在README和PyPI项目描述的显眼位置说明：

[project]
# 其他配置...
dependencies = [
    "qiskit==1.0.0",
    "qiskit-nature>=0.5.1",
    "numpy>=1.23.0",
    "deprecated>=1.2.0",
    # 注意：Psi4只能通过conda安装，命令：conda install -c psi4 psi4
]

README中直接放置醒目标识：

🔴 重要依赖提示：本包依赖的Psi4未上架PyPI，仅能通过Conda安装。请先执行conda install -c psi4 psi4完成Psi4部署，再用pip安装本包。

2. 安装前检查报错 #

用hatchling的前置钩子，在用户开始安装你的包时就检查是否有Psi4，没有则直接报错：

• 配置钩子：

[tool.hatch.build.hooks.custom]
script = "scripts/pre_check.py"

• 编写检查脚本：

import sys

try:
    import psi4
except ImportError:
    print("错误：缺少必需依赖Psi4！请先通过conda安装：conda install -c psi4 psi4", file=sys.stderr)
    sys.exit(1)

这样用户用pip安装时，第一步就会看到提示，不会白跑安装流程。

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