启动参数怎么选：--lowvram / --novram / --highvram / --normalvram / --gpu-only / --reserve-vram / --disable-smart-memory 的真实语义

--lowvram        Doesn't do anything if dynamic vram is enabled. If dynamic vram isn't being used this option makes the text encoders run on the CPU.
--novram         When lowvram isn't enough.
--highvram       By default models will be unloaded to CPU memory after being used. This option keeps them in GPU memory.
--gpu-only       Store and run everything (text encoders/CLIP models, etc... on the GPU).
--reserve-vram   Set the amount of vram in GB you want to reserve for use by your OS/other software. By default some amount is reserved depending on your OS.
--disable-smart-memory  Force ComfyUI to agressively offload to regular ram instead of keeping models in vram when it can.
--async-offload  Use async weight offloading. An optional argument controls the amount of offload streams. Default is 2. Enabled by default on Nvidia.

现象与触发场景

常见触发场景：

• 用户按旧教程加 --lowvram，但新版启用 Dynamic VRAM 后该参数不起作用
• 同时写了 --lowvram 与 --highvram 导致参数解析报错
• 照抄 --gpu-only 反而把文本编码器压到显存里，直接 OOM

根因

• comfy/cli_args.py 中 --gpu-only、--highvram、--lowvram、--novram、--cpu 属于同一个互斥组（vram_group），同时只能用一个。
• 新版 ComfyUI 默认启用 Dynamic VRAM，--lowvram 的 help 已明确写着 'Doesn't do anything if dynamic vram is enabled'；需要通过 comfy/cli_args.py 中 is_dynamic_vram 的判断（args.disable_dynamic_vram 等）来理解实际生效逻辑。
• 所以“抄参数”在旧版教程与新版行为之间会产生完全相反的效果。

解决步骤

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

1. 先分清互斥组，只选一个显存模式
   --gpu-only / --highvram / --lowvram / --novram / --cpu 五选一。显存不足时不要用 --gpu-only 和 --highvram（它们是把模型更多放进显存），依次尝试 --lowvram -> --novram -> --cpu。--cpu 官方 help 注明是“very slow but works with any hardware, only use as absolute last resort”。
   python main.py --lowvram
   python main.py --novram
   python main.py --cpu
2. 用不冲突的独立参数控制显存与内存
   --reserve-vram、--disable-smart-memory、--async-offload、--preview-method、--cache-* 都不在互斥组里，可以和显存模式参数叠加。推荐的小显存组合是：--reserve-vram 1-2 + --disable-smart-memory + --preview-method none。
   python main.py --reserve-vram 2 --disable-smart-memory --preview-method none
   python main.py --novram --disable-smart-memory --cache-none
3. 新版不确定时先看启动日志，再决定是否需要 --disable-dynamic-vram
   启动日志会打印 'Set vram state to: ...'。若已启用 Dynamic VRAM，--lowvram 无效，应按需改用 --vram-headroom（为 DynamicVRAM 额外保留的显存 GB 数）或 --disable-dynamic-vram 回到旧的按估算加载模式。注意 --disable-dynamic-vram 在部分场景会更快但更吃显存（issue #16551 报告禁用后同工作流从 1.07 it/s 提升到 1.72 it/s）。
   python main.py --vram-headroom 1
   python main.py --disable-dynamic-vram
   python main.py --disable-smart-memory --preview-method none
4. AMD 用户可参考的实测组合
   官方 issue #11624 的作者在 RX 7900 XTX 上做了大量对比，结论是 --use-pytorch-cross-attention --disable-smart-memory 组合最快且在高负载下最不容易崩；该 issue 建议把这两个参数写进 run_amd_gpu.bat 的默认命令行。
   .\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --use-pytorch-cross-attention --disable-smart-memory

验证是否修好

补充说明

本条 error_text 逐行摘自 comfy/cli_args.py（master 分支）中各参数的 help 原文。注意：旧教程中常见的 --normalvram 在当前 cli_args.py 的 vram_group 里已不存在（只有 --gpu-only/--highvram/--lowvram/--novram/--cpu），传 --normalvram 会报未识别参数；官方排障文档未列出该参数。[未核实] 具体从哪个版本起移除 --normalvram 未逐版本核对。　[未核实] 本条解决步骤中提到的那组性能对比数字（禁用 dynamic VRAM 后同一工作流 1.07 it/s → 1.72 it/s）出自 issue #16551，本次合稿复核未能在搜索引擎侧独立确认该 issue 是否存在，请把这组数字当作待验证的参考值，不要作为决策依据。本条其余结论（各参数的官方 help 原文、--normalvram 已不存在、--lowvram 在 dynamic vram 下失效）均已与本机 ComfyUI 0.37.0 的 comfy/cli_args.py 逐条核对一致，不依赖该 issue。

来源

1. [35] （官方文档）　ComfyUI/comfy/cli_args.py（参数与 help 原文）　https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py
2. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues - ComfyUI Documentation　https://docs.comfy.org/troubleshooting/overview
3. [56] （官方 issue）　update default command-line arguments for run_amd_gpu.bat · Issue #116　https://github.com/Comfy-Org/ComfyUI/issues/11624
4. [57] （官方 issue）　Dynamic VRAM prevents native FP8 compute for weight_dtype fp8_e4m3fn_f　https://github.com/Comfy-Org/ComfyUI/issues/16551

这条报错要用到的东西

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

同一类别的其他条目

返回报错库