故障排查

ValueError: numpy.dtype size changed

通常是 NumPy/Pandas 二进制兼容性问题。

pip install --upgrade --force-reinstall "numpy>=1.26.4" "pandas>=2.1.4"

重装后请重启 Python 内核或会话。

Scores column not found

调用顺序应为：先拟合打分模型，再预测分数，再匹配。

matcher.fit_scores(...)
matcher.predict_scores()
matcher.match(...)

读取数据报 FileNotFoundError

优先使用仓库相对路径：

pd.read_csv("misc/loan.csv")

匹配结果为空

常见原因是阈值过严或组间重叠不足。

• 适度增大 threshold

• 更换 model_type

• 先用 plot_scores() 检查组间得分重叠

Notebook 内核不可用

若 notebook 的 kernelspec 不存在，请切换到可用内核（如 python3）后重跑。