[{"data":1,"prerenderedAt":465},["ShallowReactive",2],{"content-/zh/advanced-tutorial/models-download":3},{"id":4,"title":5,"body":6,"description":16,"extension":458,"meta":459,"navigation":460,"path":461,"seo":462,"stem":463,"__hash__":464},"content/zh/advanced-tutorial/models-download.md","如何从 Civitai 下载模型并加载到 ComfyUI",{"type":7,"value":8,"toc":435},"minimark",[9,13,17,21,24,27,30,54,57,60,63,67,72,125,129,149,152,168,170,174,178,181,271,282,286,326,330,341,343,347,351,378,382,396,400,417,421],[10,11,5],"h1",{"id":12},"如何从-civitai-下载模型并加载到-comfyui",[14,15,16],"p",{},"一份在 ComfyUI 中安装与使用模型、提升 AI 图像生成效果的分步教程。本文会介绍两种不同方式（Civitai 和 Hugging Face），两种方法思路相近，但存在一些细节差异。",[18,19,20],"h2",{"id":20},"简介",[14,22,23],{},"Civitai 是目前主流的 AI 模型分享平台。本教程将一步步带你从 Civitai 查找、下载模型，并正确加载到 ComfyUI 中，保证模型兼容与最佳运行效果。",[18,25,26],{"id":26},"准备工作",[14,28,29],{},"开始前，请确保你已具备：",[31,32,33,45,48,51],"ul",{},[34,35,36,37,44],"li",{},"可正常运行的 ComfyUI（如未安装，可参考 ",[38,39,43],"a",{"href":40,"rel":41},"https://comfyui-box.com/basic-tutorial/installation",[42],"nofollow","ComfyUI 安装教程","）",[34,46,47],{},"稳定的网络（模型大小从 1GB 到 10GB 以上不等）",[34,49,50],{},"足够的存储空间（建议预留 20GB 以上空间存放模型）",[34,52,53],{},"了解 ComfyUI 基本文件结构",[18,55,56],{"id":56},"开始之前",[14,58,59],{},"本节主要以 z-image-turbo 这类 LoRA 模型为例。如果你需要下载其他类型模型，如 LoRA、Embedding 等，方法基本一致。",[61,62],"hr",{},[18,64,66],{"id":65},"第一部分从-civitai-下载模型","第一部分：从 Civitai 下载模型",[68,69,71],"h3",{"id":70},"从-civitai进入网站并搜索模型","从 Civitai：进入网站并搜索模型",[73,74,75,83,86],"ol",{},[34,76,77,78],{},"打开浏览器，访问 ",[38,79,82],{"href":80,"rel":81},"https://civitai.com/",[42],"Civitai.com",[34,84,85],{},"使用顶部搜索栏，按名称（如 Realistic Vision、DreamShaper）或分类查找模型",[34,87,88,89],{},"使用左侧边栏筛选结果：\n",[31,90,91,98,104,111,118],{},[34,92,93,97],{},[94,95,96],"strong",{},"Model Type（模型类型）","：选择模型类型（Checkpoint、LoRA、ControlNet、Embedding 等）",[34,99,100,103],{},[94,101,102],{},"Base Model（底模型）","：选择兼容版本（如 SD 1.5、SDXL 1.0，版本即使只差少量字符也不兼容）",[34,105,106,107,110],{},"阅读",[94,108,109],{},"描述（Description）","，了解使用场景、优势与推荐提示词",[34,112,113,114,117],{},"查看",[94,115,116],{},"示例图（Sample Images）","，确认模型出图风格",[34,119,120,121,124],{},"留意",[94,122,123],{},"文件大小（File Size）","，确保有足够存储空间",[68,126,128],{"id":127},"从-hugging-face进入网站并搜索模型","从 Hugging Face：进入网站并搜索模型",[73,130,131,138,141],{},[34,132,77,133],{},[38,134,137],{"href":135,"rel":136},"https://huggingface.co/",[42],"Hugging Face",[34,139,140],{},"使用顶部搜索栏，按名称（如 z-image-turbo_fp8）或分类查找模型",[34,142,143,144,148],{},"进入 ",[145,146,147],"code",{},"files and versions"," 板块，选择要下载的模型文件",[14,150,151],{},"补充说明：",[73,153,154,161],{},[34,155,156,157,160],{},"你可以从 Hugging Face 下载 VAE、test_encoders 等模型，但",[94,158,159],{},"不要下载 transformers 文件夹里的 diffusion 模型","：它们未经过量化，体积巨大，且在 ComfyUI 中不兼容。",[34,162,163,164,167],{},"下载社区提供的",[94,165,166],{},"量化版本模型","。在页面右侧找到 model tree 区域，选择量化模型链接，里面大多是 GGUF 格式。",[61,169],{},[18,171,173],{"id":172},"第二部分将模型加载到-comfyui","第二部分：将模型加载到 ComfyUI",[68,175,177],{"id":176},"步骤-1找到-comfyui-模型目录","步骤 1：找到 ComfyUI 模型目录",[14,179,180],{},"首先找到你的 ComfyUI 安装文件夹，默认模型存放路径如下：",[182,183,184,197],"table",{},[185,186,187],"thead",{},[188,189,190,194],"tr",{},[191,192,193],"th",{},"模型类型",[191,195,196],{},"ComfyUI 路径",[198,199,200,211,221,231,241,251,261],"tbody",{},[188,201,202,206],{},[203,204,205],"td",{},"Checkpoints（高阶模型基本不再使用）",[203,207,208],{},[145,209,210],{},"ComfyUI/models/checkpoints/",[188,212,213,216],{},[203,214,215],{},"Diffusion 模型",[203,217,218],{},[145,219,220],{},"ComfyUI/models/diffusion_models/",[188,222,223,226],{},[203,224,225],{},"文本编码器",[203,227,228],{},[145,229,230],{},"ComfyUI/models/text_encoder_models/",[188,232,233,236],{},[203,234,235],{},"LoRA",[203,237,238],{},[145,239,240],{},"ComfyUI/models/lora/",[188,242,243,246],{},[203,244,245],{},"ControlNet",[203,247,248],{},[145,249,250],{},"ComfyUI/models/controlnet/",[188,252,253,256],{},[203,254,255],{},"VAE",[203,257,258],{},[145,259,260],{},"ComfyUI/models/vae/",[188,262,263,266],{},[203,264,265],{},"放大模型",[203,267,268],{},[145,269,270],{},"ComfyUI/models/upscale_models/",[14,272,273,274,277,278,281],{},":::tip 整理建议\n在每个目录里新建子文件夹（如 ",[145,275,276],{},"lora/character/","、",[145,279,280],{},"controlnet/pose/","），方便模型增多后管理，且软件仍能正常读取。\n:::",[68,283,285],{"id":284},"步骤-2安装下载好的模型","步骤 2：安装下载好的模型",[73,287,288,291,301,308],{},[34,289,290],{},"找到下载的模型文件（通常在浏览器的“下载”文件夹）",[34,292,293,294,297,298,44],{},"复制或移动文件到",[94,295,296],{},"对应的 ComfyUI 模型目录","（例如 LoRA 文件 → ",[145,299,300],{},"models/lora/",[34,302,303,304,307],{},"除非你清楚后果，否则",[94,305,306],{},"不要","重命名文件（部分模型依赖特定命名规则）",[34,309,310,311,277,314,317,318],{},"压缩包文件（",[145,312,313],{},".zip",[145,315,316],{},".rar","）：\n",[31,319,320,323],{},[34,321,322],{},"先解压",[34,324,325],{},"将解压后的文件（而非压缩包本身）放入模型目录",[68,327,329],{"id":328},"步骤-3重启-comfyui","步骤 3：重启 ComfyUI",[73,331,332,335,338],{},[34,333,334],{},"完全关闭 ComfyUI",[34,336,337],{},"重新打开，让软件检测新模型",[34,339,340],{},"等待 ComfyUI 加载——启动时会自动扫描模型",[61,342],{},[18,344,346],{"id":345},"第三部分常见问题排查","第三部分：常见问题排查",[68,348,350],{"id":349},"问题-1模型在-comfyui-中不显示","问题 1：模型在 ComfyUI 中不显示",[31,352,353,366,372,375],{},[34,354,355,356,359,360,362,363,44],{},"确认模型放在",[94,357,358],{},"正确目录","（如 LoRA 放在 ",[145,361,300],{},"，而非 ",[145,364,365],{},"models/checkpoints/",[34,367,368,369,44],{},"确保文件格式支持（推荐 ",[145,370,371],{},".safetensors",[34,373,374],{},"再次重启 ComfyUI（有时需要重启两次才会显示）",[34,376,377],{},"检查文件是否下载损坏（必要时重新下载）",[68,379,381],{"id":380},"问题-2加载模型导致-comfyui-崩溃","问题 2：加载模型导致 ComfyUI 崩溃",[31,383,384,387,390,393],{},[34,385,386],{},"模型与 ComfyUI 版本不兼容（更新 ComfyUI）",[34,388,389],{},"显存不足：使用更小模型（如精简版），或在 ComfyUI 设置中开启模型卸载",[34,391,392],{},"文件损坏：从 Civitai 重新下载",[34,394,395],{},"底模型不匹配（如将 SDXL 模型用于 SD 1.5 工作流）",[68,397,399],{"id":398},"问题-3出图效果差","问题 3：出图效果差",[31,401,402,408,411,414],{},[34,403,404,405],{},"使用 Civitai 模型页面提供的",[94,406,407],{},"推荐提示词",[34,409,410],{},"调整模型强度（LoRA / ControlNet）",[34,412,413],{},"确保使用正确的 VAE（部分模型需要指定 VAE 才能达到最佳效果）",[34,415,416],{},"检查模型版本兼容性（如 SDXL 0.9 与 SDXL 1.0）",[68,418,420],{"id":419},"问题-4生成速度很慢","问题 4：生成速度很慢",[31,422,423,426,429,432],{},[34,424,425],{},"在 ComfyUI 设置中开启模型卸载（Settings → Performance → Enable Model Offloading）",[34,427,428],{},"降低分辨率或批次大小",[34,430,431],{},"对大模型使用量化版本（如 4bit/8bit）",[34,433,434],{},"升级显卡显存（长期处理大模型的解决方案）",{"title":436,"searchDepth":437,"depth":437,"links":438},"",2,[439,440,441,442,447,452],{"id":20,"depth":437,"text":20},{"id":26,"depth":437,"text":26},{"id":56,"depth":437,"text":56},{"id":65,"depth":437,"text":66,"children":443},[444,446],{"id":70,"depth":445,"text":71},3,{"id":127,"depth":445,"text":128},{"id":172,"depth":437,"text":173,"children":448},[449,450,451],{"id":176,"depth":445,"text":177},{"id":284,"depth":445,"text":285},{"id":328,"depth":445,"text":329},{"id":345,"depth":437,"text":346,"children":453},[454,455,456,457],{"id":349,"depth":445,"text":350},{"id":380,"depth":445,"text":381},{"id":398,"depth":445,"text":399},{"id":419,"depth":445,"text":420},"md",{},true,"/zh/advanced-tutorial/models-download",{"title":5,"description":16},"zh/advanced-tutorial/models-download","SpfVHCCi6W7Q6hBf2o1kJwHNftqutc8a5E8c-JixbYU",1773986044745]