自定义节点装完 / 更新依赖后 torch 被偷换成 CPU 版（依赖漂移）

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
torchvision 0.20.1+cu124 requires torch==2.5.1+cu124, but you have torch 2.5.1+cpu which is incompatible.
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• 自定义节点的 requirements.txt 写了 torch>=2.x 之类的无版本约束依赖
• 用 ComfyUI-Manager 安装节点时自动执行了 pip install -r requirements.txt
• 同时装了多个对 torch 版本要求不同的节点

根因

• 绝大多数自定义节点的 requirements.txt 不带 --index-url，pip 在处理这些依赖时会从默认 PyPI 取 torch，而 Windows 上 PyPI 的 torch 默认就是 CPU 版，于是把可用的 CUDA 版覆盖掉。
• ComfyUI-Manager 提供了专门针对这一问题的配置项：config.ini 的 downgrade_blacklist（禁止降级指定包）、pip_blacklist.list（禁止安装指定包）、pip_auto_fix.list（启动时自动恢复指定版本）、pip_overrides.json（把某个包的安装动作改写成自定义命令），说明“节点依赖覆盖核心库”是被官方文档承认的常见故障。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 先把 torch 恢复成正确的 CUDA 版
   不要重装 ComfyUI，只修 torch：卸载三件套后从正确的 cu 索引重装（50 系用 cu128 及以上），装完立刻核对版本后缀。
   .\python_embeded\python.exe -m pip uninstall -y torch torchvision torchaudio
   .\python_embeded\python.exe -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
   .\python_embeded\python.exe -c "import torch; print(torch.__version__, torch.cuda.is_available())"
2. 在 ComfyUI-Manager 里加上防覆盖配置
   编辑 Manager 的 config.ini（v0.3.76+ 位于 <USER_DIRECTORY>/__manager/，更早版本位于 <USER_DIRECTORY>/default/ComfyUI-Manager/），把 torch/torchvision/torchaudio 写入 downgrade_blacklist；需要更强保护时用 pip_blacklist.list 直接禁止安装这些包，或用 pip_auto_fix.list 写死正确版本让 Manager 在启动时自动恢复。
   downgrade_blacklist = torch, torchvision, torchaudio
   # pip_auto_fix.list 示例（每行一个 pip 需求，可用 --index-url）
   torch==2.11.0+cu128 --index-url https://download.pytorch.org/whl/cu128
3. 安装节点依赖时用 --no-deps 隔离风险，并在每次装完后复查 torch
   对手工安装的节点，先读它的 requirements.txt，如果里面出现 torch/torchvision/torchaudio/xformers 就提高警惕；确认不影响核心库后再装，或者用 --no-deps 只装真正缺少的小包。每次装完节点都重新跑一次 torch 版本检查，一旦发现 torch.version.cuda 变了就立刻按第 1 步恢复。
   .\python_embeded\python.exe -m pip install <包名> --no-deps
   .\python_embeded\python.exe -m pip check

验证是否修好

补充说明

本条 error_text 是根据 pip 依赖冲突告警的通用格式整理的，未取得逐字原文，故标记为非逐字。downgrade_blacklist / pip_blacklist / pip_auto_fix / pip_overrides 这些配置项名称与作用均取自 ComfyUI-Manager 官方配置文档原文。

来源

1. [81] （官方文档）　ComfyUI-Manager Configuration - ComfyUI　https://docs.comfy.org/manager/configuration
2. [68] （官方文档）　Troubleshooting Custom Node Issues - ComfyUI　https://docs.comfy.org/troubleshooting/custom-node-issues
3. [145] （社区）　How do I fix "Torch not compiled with CUDA enabled after using Manager　https://forum.smartart.live/topic/521-how-do-i-fix-torch-not-compiled-with-cuda-enabled-after-using-manager-to-install-a-custom-node-in-comfyui/
4. [138] （社区）　ComfyUI 'Torch not compiled with CUDA enabled'? Every Fix That Works o　https://dev.to/jovan_chan_9500711396d4e6/comfyui-torch-not-compiled-with-cuda-enabled-every-fix-that-works-on-windows-linux-and-mac-556m

这条报错要用到的东西

按本条报错所属的类别（PyTorch、CUDA 运行库与加速库冲突）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库