blend_modes 能导入却混合失败：检查通道、数值范围和透明度
混合节点的异常可能发生在导入，也可能发生在图像数组运算。包名、输入通道、数组类型和透明度参数需要分别核对，不能用“强制转成四通道”覆盖所有情况。
现象与适用范围
混合节点的异常可能发生在导入，也可能发生在图像数组运算。包名、输入通道、数组类型和透明度参数需要分别核对，不能用“强制转成四通道”覆盖所有情况。
检索片段；具体版本与异常上下文可能不同：
No module named 'blend_modes'
已核对的依据
blend_modes 文档给出的接口对图像数组格式和透明度参数有明确要求，包括浮点数组、RGBA 及所用数值范围。该约定不应被直接套到所有图像节点的内部表示。 V04-BLEND
需要区分的情况
1. 正确解释器中不存在 blend_modes，节点在注册前就导入失败。
2. 包可以导入，但输入数组通道、类型或尺寸不符合被调用函数的要求。
3. 运算不报错但亮度、透明度异常，可能是节点转换到库约定时处理了错误的数值范围。
建议的排查顺序
以下为本站编排的操作建议，不表示已定位你的具体环境。
1. 对照节点仓库声明确认分发包与导入名，并保存异常产生的位置。导入未通过时先处理该环境中的安装问题。
2. 导入通过后，记录节点送入函数前的数组形状、数据类型、数值范围与透明度参数；只记录统计信息，不上传用户图片。
3. 与对应函数的官方输入约定逐项比较，在节点提供的转换环节修正。需要新增 alpha 通道时明确不透明或遮罩的含义，不能仅为了消除异常随意填值。
4. 用尺寸相同的两张简单测试图验证混合和透明度，再恢复原输入。只改一项参数并保存前后结果，便于判断修复是否引入色彩偏移。
怎样判断这一层已解决
输入符合函数约定、运算正常，并且已知测试图的色彩和透明度符合预期。没有异常并不代表混合结果正确。
注意事项和适用边界
本文不声称所有 ComfyUI 节点都使用相同的数组范围。应以具体节点的转换代码和所调用函数为准，不改变原始图片覆盖保存。
资料核对：2026-09-22。本站未执行安装、GPU 推理或用户环境修复。
原始来源
- blend_modes documentation · 2026-09-22
相关排查
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
把完整日志粘贴到报错排查工具这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游资料独立编写的草稿，未运行验证；版本观察限定到对应资料，未知封装身份明确保留。
01blend_modes documentation资料核对: 2026-09-22报告问题 · a1b3a424-3855-5206-a6e9-e35e57c28d8b
相关阅读
编辑为本页关联的条目。
用环境信息、单次变更和相同输入记录排查过程，区分安装记录、依赖检查和真实运行。