3个试验设计工具选型最佳实践
版本升级后 API 全变了，这种痛谁懂？上周我刚把项目里的 doe 库从 0.9 升到 1.0，结果连最基础的因子设计接口都改名了，文档滞后一周，我在 PyPI 官方包页面翻了半天 Changelog 才找到迁移指南。做试验设计（Design of Experiments, DOE）的朋友都知道，这不是小修小补，是底层逻辑的重构。很多新人一上来就抄代码，结果版本一换，代码全废。今天不讲虚的，直接对比三个主流 Python 库：PyDOE2、PyDOE3 和 statsmodels，帮你避开这个坑。
各自定位与现状
先搞清楚这三个库是谁，处于什么阶段。
PyDOE2 是老牌选手，基于早期的 DOE 理论实现。它在 GitHub 上 Star 数不多，但胜在稳定。它的 API 设计比较传统，函数命名直白，比如 ff2n 生成全因子设计。缺点是维护频率低，最后一次主要更新在两年多前。对于只需要生成简单因子表、不需要复杂统计推断的场景，它足够用。
PyDOE3 是 PyDOE2 的演进版，也是目前社区推荐的主力。它重写了底层矩阵运算，性能提升了约 30%，并且修复了大量边界条件 bug。它的 API 与 PyDOE2 保持向后兼容，但新增了对响应面法（RSM）的支持。如果你是从旧项目迁移，PyDOE3 是首选。我在 PyPI 官方包页面看到，它的下载量在过去半年翻了倍，说明用户正在大规模迁移。
statsmodels 则是另一个维度的存在。它不是专门的 DOE 库，而是统计模型库。但它内置了强大的 ANOVA 和回归分析功能，适合在生成试验方案后，直接在同一环境中完成数据分析。它的优势在于生态完整，劣势在于生成试验方案的灵活性不如前两者。比如，生成 Box-Behnken 设计，statsmodels 没有直接函数，你得自己拼。
核心差异对比
为了直观，我列了个表，涵盖 API 稳定性、功能覆盖、学习曲线和社区活跃度。特性
PyDOE2
PyDOE3
statsmodelsAPI 稳定性
高，几乎无变动
中高，1.0 版有接口调整
高，遵循严格版本规范试验设计类型
全因子、部分因子
全因子、部分因子、响应面
需手动构造，侧重分析性能表现
一般，小数据量可用
优，支持大规模矩阵运算
优，Cython 加速文档质量
陈旧，示例少
较新，有 Jupyter 示例
极佳，官方教程完善适用场景
简单因子筛选
工业 DOE 全流程
复杂统计建模版本兼容性
支持 Python 3.6+
支持 Python 3.8+
支持 Python 3.7+注意 PyDOE3 的 API 调整。比如，旧版 cf2n 函数在 1.0 版中参数顺序变了，第一个参数从 n_factors 改为 levels。这种细微变化，如果不看 Changelog，直接报错。这就是为什么我在开头强调版本升级的痛。
代码写法对比
光说不练假把式。下面用三个库分别生成一个 3 因子、2 水平的全因子设计（Full Factorial Design），并输出前 5 行结果。
PyDOE2 写法
# 安装: pip install PyDOE2
import numpy as np
from PyDOE2 import ff2n# 生成 3 因子，2 水平的全因子设计
design_pydoe2 = ff2n(3)
print(PyDOE2 Design:)
print(design_pydoe2[:5])ff2n(3) 表示 3 个因子，默认 2 水平。输出是一个 NumPy 数组，-1 和 1 分别代表低水平和高水平。代码简洁，但无法直接控制编码值。比如，你希望因子 A 的范围是 10 到 20，PyDOE2 不直接支持，得后处理。
PyDOE3 写法
# 安装: pip install PyDOE3
import numpy as np
from PyDOE3 import ff2n# 生成 3 因子，2 水平的全因子设计
# 注意：1.0 版中，levels 参数默认为 2，但建议显式指定
design_pydoe3 = ff2n(3, levels=2)
print(\nPyDOE3 Design:)
print(design_pydoe3[:5])# 进阶：自定义水平值
# 假设因子 1: 10, 20; 因子 2: 5, 15; 因子 3: 1, 3
custom_levels = [[10, 20], [5, 15], [1, 3]]
design_custom = ff2n(3, levels=custom_levels)
print(\nPyDOE3 Custom Design:)
print(design_custom[:5])PyDOE3 的亮点是 levels 参数支持嵌套列表。你可以直接传入每个因子的具体水平值，不用后处理。这在工业应用中很关键，因为因子往往有物理单位，比如温度、压力。直接生成真实值，减少一步转换，也减少了出错概率。
statsmodels 写法
statsmodels 没有直接的 ff2n 函数，但可以通过 patsy 公式接口或手动构造。这里用一种更实用的方式：用 numpy 构造设计矩阵，再用 statsmodels 进行 ANOVA 分析。
# 安装: pip install statsmodels
import numpy as np
import statsmodels.api as sm
from statsmodels.formula.api import ols# 手动构造 3 因子 2 水平全因子设计
# 使用 itertools 生成所有组合
import itertools
factors = itertools.product([-1, 1], repeat=3)
design_sm = np.array(list(factors))
print(\nStatsmodels Design (Manual):)
print(design_sm[:5])# 假设响应变量 y，进行 ANOVA
np.random.seed(42)
y = np.random.randn(len(design_sm)) # 模拟响应# 构建公式
formula = 'y ~ A + B + C + A:B + A:C + B:C + A:B:C'
data = pd.DataFrame({'A': design_sm[:, 0],'B': design_sm[:, 1],'C': design_sm[:, 2],'y': y
})# 拟合模型
model = ols(formula, data=data).fit()
print(model.summary())这里的关键是 ols 函数。它接受 patsy 公式字符串，自动处理交互项。你不需要手动计算交互列，statsmodels 帮你搞定。但代价是，你必须自己构造设计矩阵。对于复杂设计，比如中心复合设计（CCD），手动构造容易出错。
适用场景与选型建议
三个库各有优劣，怎么选？看你的需求。
选 PyDOE2 如果：你只需要生成简单的全因子或部分因子设计。
项目对性能要求不高，数据量小于 1000 行。
你希望代码简洁，不需要复杂的水平自定义。
警告：新项目不建议用，维护风险高。选 PyDOE3 如果：你需要工业级的 DOE 流程，包括响应面法（RSM）。
你需要自定义水平值，直接生成真实物理单位。
你担心版本兼容性，希望社区活跃、文档较新。
推荐：大多数工程类毕业生和初级工程师的首选。它在 PyPI 官方包页面的依赖关系清晰，安装简单，没有复杂的 C 扩展依赖。选 statsmodels 如果：你已经有设计矩阵，只需要做统计分析和假设检验。
你需要复杂的交互项模型，比如三阶交互。
你熟悉 patsy 公式语法，喜欢声明式编程。
警告：生成试验方案的能力弱，不适合从零开始设计实验。进阶技巧与避坑
讲几个实战中踩过的坑。
坑 1：因子水平编码混淆
很多新人把 -1 和 1 当成真实值。比如，因子是温度，-1 不代表 -1 度，而是低水平。PyDOE3 的 levels 参数解决了这个问题，但如果你用 PyDOE2，必须自己映射。建议在代码注释中明确写出水平对应的真实值，避免后续分析时搞混。
坑 2：交互项遗漏
在 statsmodels 中，如果你只写 y ~ A + B + C，模型就忽略了交互项。DOE 的核心就是分析交互效应。务必加上 A:B 等交互项。PyDOE3 生成的矩阵本身不包含交互列，需要你手动计算或后处理。
坑 3：版本依赖冲突
PyDOE3 依赖 numpy 和 scipy。如果你的项目用了旧版 numpy，可能会报 AttributeError。建议在 requirements.txt 中锁定版本：numpy=1.21.0 和 PyDOE3=1.0.0。我在 PyPI 官方包页面看到，PyDOE3 的维护者对依赖版本管理很严格，遵循语义化版本，升级前一定读 Changelog。
坑 4：响应面法（RSM）的二次项
RSM 需要二次项，比如 \(A^2\)。PyDOE3 的 cf2n 函数不直接生成二次项，你需要用 numpy 的 **2 操作。statsmodels 的 patsy 公式支持 I(A**2)，更简洁。如果你做 RSM，statsmodels 的分析部分更省力。
结尾互动引导
试验设计是个细节活，版本升级、API 变更、编码混淆，每一步都可能让结果失真。我用的 PyDOE3 1.0 版，在迁移过程中花了两天时间调试，主要卡在水平自定义的边界条件上。你在项目里踩过这个坑吗？是用 PyDOE2 还是 PyDOE3？或者你更倾向用 statsmodels 一站式解决？评论区聊聊，分享你的迁移经验和避坑技巧。
