Python 包构建（如使用 build 工具）本质是元数据驱动的源码归档过程，不执行用户代码，因此无需安装 numpy 等运行时依赖；关键在于 pyproject.toml 中正确声明 dependencies，确保 pip install 时自动补全所需库。
python 包构建无需依赖运行时环境：为什么打包可脱离项目依赖独立完成
在 Python 项目分发实践中，一个常见却易被误解的问题是：构建包是否必须在包含所有运行时依赖（如 numpy、pandas）的环境中进行？ 答案是否定的——构建（building）与运行（running）是两个正交阶段，现代 Python 打包工具（如 build、hatch、flit）的设计哲学正是“构建即声明，运行靠约束”。
✅ 构建的本质：声明式归档，而非执行式编译
当你执行 python -m build 时，工具实际完成的是以下操作：
- 解析 pyproject.toml（或旧式 setup.py）中的元数据；
- 读取 src/ 或顶层目录下的源码文件（.py）；
- 将其按 PEP 517/518 规范打包为 .tar.gz（sdist）或 .whl（wheel）；
- 全程不导入、不执行你的模块代码（例如不会调用 add_ones(array)）。
这意味着：即使你的 packaging conda 环境中完全未安装 numpy，只要 pyproject.toml 正确声明了依赖：
# pyproject.toml
[project]
name = "my-math-utils"
version = "0.1.0"
description = "Utilities using NumPy"
requires-python = ">=3.8"
dependencies = [
"numpy>=1.21",
]
构建过程就能成功完成。生成的 wheel 文件内仅包含纯 Python 源码和元数据，不含任何二进制或预编译产物（这与 PyInstaller 等打包工具有本质区别）。
⚠️ 关键前提：依赖必须显式、准确声明
构建虽不需运行时依赖，但缺失或错误的依赖声明将直接导致用户安装后失败。例如：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
| 错误写法 | 后果 |
|---|---|
| dependencies = []（空列表） | pip install my-math-utils 成功，但 import mymath 报 ModuleNotFoundError: No module named 'numpy' |
| dependencies = ["numpy"]（无版本） | 可能因新版 numpy API 不兼容导致运行时异常 |
| 动态导入未覆盖（如 importlib.import_module("scipy.sparse")） | 静态分析无法识别，需在 dependencies 中显式补充 |
✅ 最佳实践：
- 使用 pip-tools 或 poetry export --format requirements.txt 验证依赖完整性；
- 在 CI 流水线中添加“构建环境隔离”步骤：新建干净虚拟环境 → 安装 build → 构建 → 验证生成的 dist/ 内容结构。
? Conda 用户特别注意：conda-build 行为略有不同
Conda 的构建流程（通过 meta.yaml + conda-build）更强调环境可复现性，它默认会在构建时解析并安装 requirements.build 和 requirements.run 中指定的包（包括编译期依赖如 gcc）。但这仍不等价于“必须在含 numpy 的环境里构建”——而是由 meta.yaml 显式控制：
# meta.yaml
requirements:
build:
- python
- pip
run:
- python
- numpy >=1.21
此处 run 下的 numpy 是运行时要求，build 阶段依然无需它存在。
✅ 总结：构建可信度 = 元数据准确性 × 工具标准化
| 维度 | 构建环境要求 | 用户安装后保障 |
|---|---|---|
| 纯 Python 包（无 C 扩展） | ✅ 无需任何 runtime 依赖 | ✅ pip 自动满足 dependencies |
| 含 C 扩展的包（如 cryptography） | ⚠️ 需要编译工具链（gcc, rustc）及头文件 | ✅ wheel 若已预编译，则免编译安装 |
| 动态加载/插件式架构 | ❗ 需额外静态分析或运行时校验（如 importlib.metadata.distribution().requires） | ✅ 仍依赖 dependencies 声明完整性 |
因此，请放心在轻量、隔离的构建环境中（如 GitHub Actions 的 ubuntu-latest + python:3.11）执行打包——真正的可靠性，不来自构建机上装了多少库，而来自你写在 pyproject.toml 里的那几行精准的 dependencies 声明。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
