%20(1).png)
ComfyUI-wanBlockswap 插件完全使用指南
1. 插件简介
插件地址： https://github.com/orssorbit/ComfyUI-wanBlockswap
ComfyUI-wanBlockswap 是一个专门为 ComfyUI 设计的显存优化插件，它的主要作用是通过把最多 40 个处理块转移到电脑的主内存（CPU）来减少显卡内存（VRAM）的占用。
简单来说： 这个插件就像是一个"搬运工"，当你的显卡内存不够用时，它会把一些不那么紧急的工作任务暂时搬到电脑的普通内存里，这样显卡就有更多空间来处理重要的图像生成任务。这对于显卡内存较小的用户来说特别有用！
能给我们带来什么效果： - 大幅减少显存占用，让低配置显卡也能运行复杂的工作流 - 避免因显存不足导致的崩溃或错误 - 提高生成效率，特别是在处理大尺寸图像时
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI
- 点击右下角的 "Manager" 按钮
- 在搜索框中输入 "wanBlockswap"
- 找到 "ComfyUI-wanBlockswap" 插件
- 点击 "Install" 安装
- 重启 ComfyUI
方法二：手动安装
- 打开你的 ComfyUI 安装目录
- 进入
custom_nodes文件夹 - 打开命令行工具（Windows 用户按 Shift+右键选择"在此处打开命令窗口"）
- 输入命令：
git clone https://github.com/orssorbit/ComfyUI-wanBlockswap.git - 重启 ComfyUI
3. 节点详细解析
3.1 WanVideoBlockSwap 节点是干嘛的？
这个节点的作用是通过有选择性地交换变换器块来增强模型处理效率，实现资源使用的优化和性能的提升。
用大白话解释： 就像是一个智能的"内存管理员"，它会根据实际需要，把一些暂时不用的处理模块放到电脑的普通内存里，腾出显卡内存给正在工作的重要模块使用。这样可以让你的显卡更高效地工作，不会因为内存不够而卡住。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型输入 | model | 模型对象 | 必填 | 这是你要处理的AI模型，就像是要优化的"工人" | 输入的扩散模型对象 | 连接你的模型加载器节点到这里 |
| 交换块数量 | swap_blocks | 数字 | 10-30 | 决定要把多少个处理块搬到普通内存里，数字越大省显存越多但速度可能稍慢 | 指定要交换到CPU的transformer块数量 | 显存紧张时调高（如30），显存充足时调低（如10） |
| 启用交换 | enable_swap | 布尔值 | True | 这是总开关，决定是否启用这个节点的功能 | 控制是否启用块交换功能 | 需要省显存时选True，测试对比时可选False |
4. 使用技巧和建议
4.1 最佳实践
- 刚开始使用时： 建议先设置交换块数量为 15-20，看看效果
- 显存非常紧张时： 可以尝试设置到 30-40 的上限
- 追求速度时： 设置较低的数值（5-10）
4.2 使用场景
- 生成高分辨率图片时： 这个插件特别有用
- 运行复杂工作流时： 能有效防止显存不足
- 多人共享GPU时： 可以减少每个人的显存占用
4.3 搭配建议
- 与其他显存优化节点配合使用效果更佳
- 建议在工作流的模型加载后立即使用
- 可以与不同的模型类型搭配使用
5. 常见问题解答
Q1: 使用这个插件后生成速度变慢了怎么办？
A: 这是正常现象。因为一些处理被转移到了CPU，速度会稍微慢一些，但这是为了节省显存的权衡。你可以适当降低交换块数量来平衡速度和显存使用。
Q2: 什么时候需要使用这个插件？
A: 当你遇到以下情况时： - 生成图片时出现显存不足的错误 - 想要生成更高分辨率的图片 - 同时运行多个ComfyUI实例 - 显卡内存小于8GB
Q3: 这个插件会影响图片质量吗？
A: 不会。这个插件只是改变了处理的方式和内存分配，不会影响最终生成的图片质量。
Q4: 如何知道设置的交换块数量是否合适？
A: 观察以下指标： - 生成过程中没有显存不足的错误 - 生成速度在可接受范围内 - GPU使用率保持稳定
6. 进阶用法
6.1 与其他优化插件组合
- 可以与 ModelManagement 节点配合使用
- 与 LowMemoryMode 节点搭配效果更佳
- 建议与批处理节点一起使用时调高交换块数量
6.2 针对不同模型的调优
- SDXL模型： 建议使用 25-35 个交换块
- SD 1.5模型： 建议使用 15-25 个交换块
- 自定义大模型： 建议从 30 开始尝试
6.3 性能监控
- 使用任务管理器观察内存使用情况
- 通过ComfyUI的控制台输出监控处理进度
- 记录不同设置下的生成时间进行对比
7. 故障排除
常见错误及解决方案：
- 节点无法找到： 检查插件是否正确安装，重启ComfyUI
- 参数报错： 确保输入的模型对象正确
- 性能下降明显： 降低交换块数量或检查CPU性能
记住，这个插件的核心理念就是"用时间换空间"，通过稍微增加处理时间来大幅节省显存。对于显卡内存有限的用户来说，这是一个非常实用的工具！