如果你下載了模型放進(jìn) ComfyUI 卻看不到它大概率不是模型壞了而是放進(jìn)了一個(gè)它不知道的文件夾。ComfyUI 不像某些工具那么“隨和”它給模型文件劃好了各自的格子checkpoints、vae、loras、controlnet 各歸各的位置放錯(cuò)一個(gè)地方加載列表里就永遠(yuǎn)找不到。這篇文章不打算只丟一張目錄樹給你而是從根目錄講到 models 內(nèi)部再講清楚外置路徑、遷移和踩坑看完你能徹底搞懂 ComfyUI 每個(gè)文件夾是干嘛的以及模型到底該放哪兒。1. 頂層目錄從根目錄說起哪些文件夾是命根子1.1 官方解壓后的標(biāo)準(zhǔn)目錄長什么樣ComfyUI 官方包Windows 便攜版解壓之后本質(zhì)上就是一個(gè)主程序目錄加一套便攜 Python 環(huán)境。打開根目錄你會(huì)看到 main.py、requirements.txt后面跟著 models、custom_nodes、input、output、temp、user、web 這一批文件夾。很多人第一眼只盯著 models 看但真正需要理解的是每個(gè)文件夾在運(yùn)行鏈路里的角色。main.py 是服務(wù)端入口雙擊啟動(dòng)腳本之后系統(tǒng)會(huì)跑這個(gè)文件把后端服務(wù)和前端頁面一起拉起來。web 文件夾裝的是前端資源界面上那些節(jié)點(diǎn)菜單、畫布交互、設(shè)置面板靜態(tài)資源基本都在這里。custom_nodes 是第三方插件目錄你在社區(qū)里下載的插件節(jié)點(diǎn)都裝在這。user 目錄存用戶配置和工作流input 管輸入圖片output 管輸出結(jié)果temp 是中間過程文件。這套結(jié)構(gòu)和 SD WebUI 那種“一個(gè) models 打天下”的思路完全不一樣。ComfyUI 的核心理念是模塊化所以目錄劃分也特別細(xì)。你不需要記住每一個(gè)文件夾的作用但至少要能區(qū)分“程序文件”和“數(shù)據(jù)文件”程序文件亂動(dòng)會(huì)導(dǎo)致啟動(dòng)失敗數(shù)據(jù)文件放錯(cuò)位置最多就是加載不到不會(huì)把軟件搞崩。1.2 哪些文件別亂動(dòng)哪些目錄可以隨便刪我把經(jīng)驗(yàn)總結(jié)成三句話。第一根目錄里的核心代碼文件不要碰除非你明確知道自己在改什么。第二temp 目錄可以放心清理ComfyUI 啟動(dòng)時(shí)會(huì)自動(dòng)重建。第三output 目錄會(huì)保存你所有生成結(jié)果想清可以清但重要輸出建議先備份。temp 這個(gè)目錄被很多人忽視但跑起來之后它是最容易膨脹的。你生成一張大尺寸圖片如果步數(shù)又高中間過程會(huì)寫大量臨時(shí)文件到 temp。一些用戶跑了幾個(gè)月temp 能膨脹到幾十 GB磁盤莫名其妙的滿了查來查去最后發(fā)現(xiàn)是這個(gè)目錄在作祟。定期清理 temp 不會(huì)影響任何已保存的圖片因?yàn)樗淮妗斑€在生成過程中”的中間數(shù)據(jù)。還有一點(diǎn)千萬不要把模型文件放在 web 目錄或者程序根目錄下。我見過有人為了方便直接把下載的模型丟在 main.py 旁邊結(jié)果界面加載列表里無論如何都看不到。ComfyUI 只會(huì)掃描指定目錄不會(huì)去全盤搜索模型所以遵守目錄約定是最基本的一步。1.3 input 目錄圖生圖和參考圖的入口input 目錄看著不起眼但它是圖生圖、局部重繪和 ControlNet 參考圖的基礎(chǔ)。在 LoadImage 節(jié)點(diǎn)上你可以點(diǎn)上傳按鈕選擇圖片也可以直接把圖片拖到畫布上ComfyUI 會(huì)自動(dòng)把圖片拷貝進(jìn) input 目錄然后在節(jié)點(diǎn)里填上相對路徑。批量處理素材時(shí)input 目錄特別有用。你把一批圖片按命名規(guī)則丟進(jìn) input然后在 LoadImage 節(jié)點(diǎn)里選擇對應(yīng)文件名就行不用一張張手動(dòng)上傳。要注意的是input 只適合放“這次工作流要用的輸入圖”不適合當(dāng)圖片倉庫。跑完任務(wù)之后及時(shí)清理不然多項(xiàng)目混在一起找圖會(huì)非常痛苦。2. models 模型目錄每個(gè)子文件夾都是給誰準(zhǔn)備的2.1 checkpoints、diffusion_models、unet大模型的三副面孔models 目錄底下才是重頭戲。先從最常用的 checkpoints 說起。SD1.5 和 SDXL 時(shí)代的完整模型safetensors 格式或 ckpt 格式都放在這里L(fēng)oad Checkpoint 節(jié)點(diǎn)加載的就是這些文件。一個(gè) checkpoint 文件就是一個(gè)“全家桶”去噪網(wǎng)絡(luò)、文本編碼器、VAE 全都在里面。你下載的任何 Animate、Anything、RealVisXL 這類大模型直接扔進(jìn) checkpoints 就完事。到了 SD3 和 Flux 時(shí)代情況變了。模型發(fā)布方不再把完整模型打包成一個(gè)文件而是拆成擴(kuò)散模型主體、文本編碼器、VAE 三部分。擴(kuò)散模型主體放在 diffusion_models 目錄文本編碼器放在 text_encodersVAE 放在 vae。如果你下載的是 flux1-dev.safetensors 這類文件要用 Load Diffusion Model 節(jié)點(diǎn)加載而不是 Load Checkpoint。最常見的困惑就在這很多人把 Flux 的拆分包誤放進(jìn) checkpoints然后在 Load Checkpoint 節(jié)點(diǎn)里看不到就以為下載壞了。其實(shí)模型沒壞只是加載器不對。diffusion_models 目錄在官方包自帶的 models 文件夾里可能沒有需要你手動(dòng)新建ComfyUI 會(huì)自動(dòng)識別。同理unet 目錄留給那些只想要去噪網(wǎng)絡(luò)部分的用戶比如從完整模型里抽出 UNet 做融合或者使用社區(qū)轉(zhuǎn)換的 UNet-only 文件。新手大概率用不到 unet 目錄但看到別人工作流里的 Load UNet 節(jié)點(diǎn)時(shí)要能反應(yīng)過來模型應(yīng)該去哪個(gè)文件夾找。2.2 vae、clip、text_encoders拼圖里的其他關(guān)鍵件vae 文件夾存放獨(dú)立 VAE 文件。為什么要單獨(dú)用 VAE因?yàn)橛行?checkpoint 自帶的 VAE 效果一般換一個(gè)更好的 VAE比如常見的 vae-ft-mse-840000能讓寫實(shí)風(fēng)格的細(xì)節(jié)紋理肉眼可見地提升。在 VAE Loader 節(jié)點(diǎn)里掛上獨(dú)立 VAE再連接到 VAE Encode/Decode 節(jié)點(diǎn)替換默認(rèn) VAE 即可。有個(gè)很隱蔽的坑如果你把 VAE 文件放進(jìn)了 checkpoints 目錄而不是 vae 目錄VAE Loader 的選擇列表里就不會(huì)出現(xiàn)它。因?yàn)?ComfyUI 的模型掃描是按目錄嚴(yán)格匹配的不會(huì)出現(xiàn)“你在別處也能看到”的好事。clip 和 text_encoders 這兩個(gè)目錄看著像雙胞胎實(shí)際有時(shí)代差異。舊模型的 CLIP 文本編碼器放在 clip 目錄用于配合 Load CLIP 節(jié)點(diǎn)SD3/Flux 系列的新編碼器則放在 text_encoders 目錄。以 Flux 為例你通常需要下載三個(gè)文件clip_l.safetensors 和 t5xxl_fp8_e4m3fn.safetensors 放到 text_encodersae.safetensors也就是 VAE放到 vae。加載時(shí)用 CLIPLoader 節(jié)點(diǎn)設(shè)置 type 為對應(yīng)類型文件選擇器從 text_encoders 里挑。放錯(cuò)目錄的直接后果是選擇列表空掉或者加載時(shí)報(bào) “CLIP model not found”。2.3 loras、controlnet、embeddings、upscale_models 這些小分類繼續(xù)往下數(shù)這些目錄每個(gè)都有明確用途目錄用途對應(yīng)加載節(jié)點(diǎn)lorasLoRA 微調(diào)模型幾十 MB 到幾百 MBLoraLoadercontrolnetControlNet 模型注意 SD1.5 和 SDXL 版本不能混用ControlNetLoaderembeddings文本反轉(zhuǎn) embedding如 easynegative在 CLIPTextEncode 里直接輸入名稱upscale_models放大模型如 4x-UltraSharp、RealESRGANUpscaleModelLoadergligenGLIGEN 模型用于布局/區(qū)域控制GLIGENLoaderhypernetworks超網(wǎng)絡(luò)文件目前使用頻率較低HypernetworkLoaderstyle_models風(fēng)格模型如 T2I-AdapterStyleModelLoaderphotomakerPhotoMaker 模型用于人像生成PhotoMakerLoader這里重點(diǎn)說兩個(gè)容易被坑的目錄。第一個(gè)是 loras它可以再建子文件夾分類但子文件夾名和文件名的中文命名在某些節(jié)點(diǎn)里可能有兼容問題我自己都是用英文或拼音。第二個(gè)是 controlnetSD1.5 的 ControlNet 和 SDXL 的 ControlNet 文件絕對不能混用你拿 SD1.5 的 ControlNet 去配 SDXL 底?？刂菩Ч苯邮Щ蛘邎?bào)錯(cuò)。下載時(shí)一定要看清文件說明里寫的是哪個(gè)版本。embeddings 目錄使用方式不太一樣。下載的 easynegative.safetensors 放進(jìn) embeddings 之后在正向提示詞或負(fù)向提示詞的 CLIPTextEncode 節(jié)點(diǎn)文本框里直接輸入 easynegative 就能生效。不需要額外加載器也不占用加載節(jié)點(diǎn)這就是 text inversion 的工作方式。2.4 模型文件命名和整理的好習(xí)慣模型文件整理這件事講究一點(diǎn)都不比技術(shù)配置少。我踩過最大的坑就是“文件名隨意化”從各種渠道下載的 LoRA文件名五花八門什么“1111.safetensors”“l(fā)atest_v2.safetensors”過三個(gè)月再想找對應(yīng)觸發(fā)詞根本對不上號?，F(xiàn)在我給自己定了一套規(guī)則文件命名包含模型名、類型、版本三個(gè)要素例如detailed_eyes_lora_v1.safetensors同時(shí)建同名 txt 說明文件里面寫清楚底模版本、觸發(fā)詞、來源鏈接、實(shí)測效果。如果是帶預(yù)覽圖的模型把預(yù)覽圖命名為模型同名 png 放在同目錄加載時(shí)鼠標(biāo)懸停就能看到縮略圖。這套習(xí)慣一開始執(zhí)行覺得繁瑣但模型量超過 100 個(gè)之后真能幫你省下大把時(shí)間。3. 模型放對位置還是不顯示從刷新到加載報(bào)錯(cuò)逐個(gè)排查3.1 最常見的情況放進(jìn)去但沒刷新很多人把模型放進(jìn)文件夾回到 ComfyUI 界面發(fā)現(xiàn)下拉列表里還是老樣子第一反應(yīng)是“壞了是不是要重啟”。其實(shí)大部分時(shí)候只需要點(diǎn)一下模型文件名下拉框旁邊的刷新按鈕。ComfyUI 不會(huì)自動(dòng)監(jiān)聽文件夾變化模型列表是在加載節(jié)點(diǎn)時(shí)讀一次目錄生成的文件放進(jìn)去之后不手動(dòng)刷新列表自然不會(huì)更新。如果點(diǎn)了刷新還沒出現(xiàn)就把整個(gè)瀏覽器頁面刷新一次。瀏覽器端緩存也可能導(dǎo)致下拉列表停留在舊狀態(tài)特別是你長時(shí)間掛著一個(gè) ComfyUI 頁面不關(guān)閉的情況下。刷新頁面不會(huì)影響當(dāng)前工作流畫布放心的刷。3.2 刷新背后的機(jī)制模型列表是“讀一次存一次”模型列表的加載機(jī)制其實(shí)很“笨”節(jié)點(diǎn)渲染時(shí)掃一遍目錄生成下拉選項(xiàng)然后把選項(xiàng)緩存住。你放文件進(jìn)去但沒觸發(fā)重新掃描緩存還是舊的如果是在跑生成任務(wù)的過程中放文件也不能立即看到。所以要養(yǎng)成的習(xí)慣是先放文件再點(diǎn)刷新再選擇模型。如果你用的是整合包有些版本還開了多工作流緩存或模型列表緩存改完目錄后最好重啟一下 ComfyUI 主進(jìn)程再測試。這不是玄學(xué)是緩存機(jī)制決定的。3.3 下載不完整、格式不對、版本錯(cuò)配三個(gè)隱藏深坑排除刷新問題之后模型還是看不到或加載不了就要考慮下面幾個(gè)情況。下載不完整是最常見的問題。瀏覽器下載中途斷網(wǎng)會(huì)生成 .part 或 .crdownload 臨時(shí)文件或者文件顯示有完整大小但校驗(yàn)不通過。一個(gè)只有幾 KB 的 safetensors 文件幾乎可以斷定是沒下完。建議用支持?jǐn)帱c(diǎn)續(xù)傳的下載工具比如 IDM、迅雷或者大的模型直接用 aria2 多線程下載。下載完看一眼文件大小是否和頁面標(biāo)注一致能避免大部分問題。格式不對也是一個(gè)原因。ckpt 是老格式現(xiàn)在很多模型發(fā)布方已經(jīng)轉(zhuǎn)向 safetensors。safetensors 格式更安全加載速度更快優(yōu)先選擇。如果遇到 .bin 或者 .pth 后綴的文件要看清楚節(jié)點(diǎn)是否支持某些節(jié)點(diǎn)只認(rèn) safetensors只認(rèn) safetensors 的場合用 ckpt 就會(huì)直接報(bào)錯(cuò)。版本錯(cuò)配則更隱蔽。ControlNet 的 SD1.5 和 SDXL 版本不能混用LoRA 的底模版本不對也會(huì)導(dǎo)致出圖異常甚至報(bào)錯(cuò)。看到加載器報(bào)錯(cuò)時(shí)先把模型文件從哪個(gè)模型版本下載的確認(rèn)一遍通常能解決一半問題。報(bào)錯(cuò)現(xiàn)象常見原因排查思路下拉列表里找不到文件放錯(cuò)目錄/沒刷新/文件未下載完成檢查目錄、點(diǎn)刷新、核對文件大小文件能看到但加載報(bào)錯(cuò)格式不支持/模型文件損壞換 safetensors 格式、重新下載ControlNet 加載后無效SD1.5 與 SDXL 版本混用核對底模版本對應(yīng)的 ControlNetVAE 加載器里沒有文件誤放到 checkpoints移到 vae 目錄4. 官方版與整合包的差異以及外置模型的正確配置4.1 秋葉整合包的目錄和官方版有什么不一樣秋葉整合包本質(zhì)上是把官方版和一套便攜 Python 環(huán)境、啟動(dòng)器打包在一起核心目錄結(jié)構(gòu)沒有變但頂層會(huì)多出啟動(dòng)器和管理工具。很多用戶搞混的是啟動(dòng)器和 ComfyUI 主程序的位置整合包的模型目錄依然在 ComfyUI\models 里不是包根目錄。啟動(dòng)器負(fù)責(zé)管理 Python 環(huán)境、自動(dòng)更新和目錄配置你在啟動(dòng)器界面上改的模型路徑最終會(huì)寫進(jìn) extra_model_paths 相關(guān)配置。整合包和官方版在 models 目錄內(nèi)部基本一致所以這篇文章講的目錄規(guī)則在兩種版本下都適用。差異主要在于“你是否方便修改配置文件”官方版需要自己手動(dòng)處理 extra_model_paths.yaml整合包一般會(huì)在啟動(dòng)器界面上幫你配置。4.2 用 extra_model_paths.yaml 把模型放到任意盤符如果你不想把所有模型都復(fù)制進(jìn) ComfyUI 的 models 目錄或者你的模型庫存放在獨(dú)立硬盤里可以用 extra_model_paths.yaml 掛載外部路徑。官方版第一次運(yùn)行后會(huì)在根目錄生成 extra_model_paths.yaml.example把它復(fù)制一份重命名為 extra_model_paths.yaml然后按下面的格式編輯other_models: base_path: E:/AI-Models checkpoints: StableDiffusion loras: Lora vae: VAE controlnet: ControlNet upscale_models: Upscale embeddings: Embeddingsbase_path 指向你存放模型的根目錄下面的鍵名對應(yīng) ComfyUI 約定目錄名。比如 E:/AI-Models/StableDiffusion 目錄里的模型ComfyUI 會(huì)把它當(dāng)成 checkpoints 目錄的內(nèi)容來掃描。這樣你不用修改 ComfyUI 本體目錄也能在一個(gè)外部目錄下自由組織模型庫。改完配置一定要重啟 ComfyUI而且不同版本對配置項(xiàng)的解析有細(xì)微差異。如果你修改后發(fā)現(xiàn)某個(gè)子目錄沒被識別檢查一下是不是目錄名和鍵名對應(yīng)錯(cuò)了。保留一份配置備份是好習(xí)慣因?yàn)槟承┱习凇耙绘I更新”之后可能會(huì)重寫覆蓋 yaml 文件。4.3 符號鏈接方案要不要用 mklink如果你用的是整合包啟動(dòng)器可能在每次啟動(dòng)時(shí)覆蓋 extra_model_paths.yaml或者你只是想給某個(gè)子目錄單獨(dú)換個(gè)位置這時(shí)候可以用目錄符號鏈接也就是 mklink。在管理員權(quán)限的命令行里執(zhí)行mklink /D D:\ComfyUI\models\loras\my_lora E:\models\loras\my_lora注意目標(biāo)位置不能已存在同名文件夾鏈接成功后ComfyUI 里看到的就是一個(gè)普通目錄底層文件實(shí)際在另一個(gè)盤符。這個(gè)方案的好處是“零配置”不用改 yaml對整合包特別友好。缺點(diǎn)是遷移時(shí)不熟悉符號鏈接的用戶容易把源文件刪掉導(dǎo)致鏈接失效。所以基本上我只推薦給已經(jīng)理解符號鏈接原理的人。日常使用的話extra_model_paths 方案更透明、更可維護(hù)。5. 目錄遷移與空間整理給 ComfyUI“搬家”的實(shí)戰(zhàn)經(jīng)驗(yàn)5.1 換盤前的準(zhǔn)備工作與遷移步驟模型目錄動(dòng)輒幾十 GB換盤或者給 ComfyUI 換位置最忌諱的是直接剪切整個(gè)目錄然后啟動(dòng)報(bào)錯(cuò)。我遷移過三次總結(jié)出一套比較穩(wěn)的流程。第一步停止 ComfyUI 和啟動(dòng)器進(jìn)程確認(rèn)沒有 Python 進(jìn)程占用模型文件否則復(fù)制過程中文件可能是損壞的。第二步用復(fù)制而不是剪切目標(biāo)磁盤空間要提前確認(rèn)夠用復(fù)制失敗可以重試。第三步大文件校驗(yàn)大的 safetensors 文件要核對哈希值或者至少確認(rèn)文件大小一致。第四步通過 extra_model_paths 或符號鏈接把新路徑指到舊地址不要直接改掉原來的目錄結(jié)構(gòu)。第五步啟動(dòng)后逐個(gè)節(jié)點(diǎn)測試加載不要一次加載一堆模型然后報(bào)錯(cuò)不好定位。全部確認(rèn)正常之后再刪除舊文件。5.2 輸出、臨時(shí)文件、日志的定期清理磁盤空間不夠時(shí)先看三個(gè)地方output、temp、更新備份。output 目錄是生成圖片的倉庫時(shí)間久了能堆好幾個(gè) GB建議定期歸檔。temp 目錄前面說過是中間過程文件可以直接清空。更新備份主要是整合包一鍵更新時(shí)自動(dòng)備份的舊版本文件確認(rèn)不需要回滾后也能刪。清理 output 和 temp 可以寫個(gè)簡單的定時(shí)腳本。Windows 下用 forfiles 命令可以按修改日期批量移動(dòng)文件forfiles /p D:\ComfyUI\output /s /m *.png /d -30 /c cmd /c move path D:\Backup\AI_Output\這條命令把 output 目錄下 30 天之前的 png 文件移到備份目錄。配合 Windows 任務(wù)計(jì)劃程序每個(gè)月自動(dòng)執(zhí)行一次就基本不用手動(dòng)操心磁盤爆滿的問題。注意路徑不要帶空格或者中文不然 forfiles 的轉(zhuǎn)義會(huì)讓人頭大。5.3 磁盤空間規(guī)劃與模型版本管理我的個(gè)人規(guī)劃是系統(tǒng)盤只放 ComfyUI 程序本體和必要的臨時(shí)文件所有模型外置到獨(dú)立的數(shù)據(jù)盤按底模版本建立一級目錄比如 SD15、SDXL、Flux、ControlNet、LoRA。每個(gè)一級目錄下再按模型系列分子目錄。版本管理上我強(qiáng)烈建議不要輕易覆蓋舊模型文件。底模更新后之前調(diào)的 LoRA 可能在新版本上效果不理想你想回退到舊底模卻發(fā)現(xiàn)文件已經(jīng)被覆蓋了那種感覺真的很崩潰。下載模型時(shí)順手在文件名里標(biāo)注版本號配合說明 txt能避免 90% 的版本混亂問題。6. custom_nodes 和 user 目錄兩塊容易被忽視的“模型區(qū)”6.1 插件目錄模型藏在“別人的文件夾”里custom_nodes 目錄下每個(gè)子文件夾就是一個(gè)第三方插件。你在社區(qū)里下載的插件一般通過 git clone 或者手動(dòng)解壓裝到這里。安裝之后基本都需要重啟 ComfyUI 才能生效部分插件還會(huì)在啟動(dòng)時(shí)自動(dòng)從網(wǎng)上下載模型到自己的子目錄里。這也是很多人找不到模型的一個(gè)重要原因有些自定義節(jié)點(diǎn)的模型文件并不在 models 全局目錄而在插件自己的子目錄里。比如某個(gè) ControlNet 輔助插件、某個(gè)修復(fù)插件它們各自有獨(dú)立的模型文件夾。當(dāng)你在全局 models 里找不到某個(gè)模型時(shí)記得去對應(yīng)插件的目錄下翻一翻。插件裝多了之后沖突問題也容易出現(xiàn)。出現(xiàn)啟動(dòng)報(bào)錯(cuò)時(shí)可以先把 custom_nodes 下可疑的插件臨時(shí)改名移出目錄再重啟看是否恢復(fù)。如果恢復(fù)就說明是這個(gè)插件的問題。別急著刪先看更新日志很多時(shí)候升級一下插件版本就解決了。6.2 user 目錄與工作流管理的建議user\default 目錄下主要存用戶配置、快捷鍵設(shè)置、默認(rèn)工作流等。界面布局或設(shè)置丟失時(shí)多半是這里的配置損壞或被還原。我自己一般會(huì)把常用工作流文件另存到工作區(qū)目錄user 目錄只留默認(rèn)設(shè)置這樣即使配置重置也不會(huì)丟失辛苦搭好的工作流。如果你有多臺設(shè)備可以把這個(gè)目錄里的核心配置文件備份到云盤或 Git 倉庫。換機(jī)之后直接放回去能少調(diào)很多界面設(shè)置。這里額外提醒一句不要在工作流文件里寫死絕對路徑除非你確定所有設(shè)備都保持同樣的目錄結(jié)構(gòu)否則換機(jī)器之后路徑必然失效。說到底ComfyUI 的目錄管理就是一套“整理癖”修行。我現(xiàn)在遇到模型不顯示第一反應(yīng)永遠(yuǎn)是按順序排查放對目錄沒有、刷新沒有、文件格式對不對、有沒有中文路徑和特殊字符。這套順序比看任何報(bào)錯(cuò)都管用。最后分享一個(gè)我自己的小技巧每次下載模型時(shí)順手寫一個(gè)說明 txt內(nèi)容就五行——模型來源、底模版本、觸發(fā)詞、測試參數(shù)、下載日期。寫完之后放到模型同目錄。別嫌麻煩等你模型積累到幾百個(gè)的時(shí)候這個(gè)習(xí)慣能幫你省出的時(shí)間比當(dāng)時(shí)下載模型的時(shí)間還多。 ComfyUI模型目錄全解析：checkpoints、LoRA、ControlNet放哪才對
如果你下載了模型放進(jìn) ComfyUI 卻看不到它大概率不是模型壞了而是放進(jìn)了一個(gè)它不知道的文件夾。ComfyUI 不像某些工具那么“隨和”它給模型文件劃好了各自的格子checkpoints、vae、loras、controlnet 各歸各的位置放錯(cuò)一個(gè)地方加載列表里就永遠(yuǎn)找不到。這篇文章不打算只丟一張目錄樹給你而是從根目錄講到 models 內(nèi)部再講清楚外置路徑、遷移和踩坑看完你能徹底搞懂 ComfyUI 每個(gè)文件夾是干嘛的以及模型到底該放哪兒。1. 頂層目錄從根目錄說起哪些文件夾是命根子1.1 官方解壓后的標(biāo)準(zhǔn)目錄長什么樣ComfyUI 官方包Windows 便攜版解壓之后本質(zhì)上就是一個(gè)主程序目錄加一套便攜 Python 環(huán)境。打開根目錄你會(huì)看到 main.py、requirements.txt后面跟著 models、custom_nodes、input、output、temp、user、web 這一批文件夾。很多人第一眼只盯著 models 看但真正需要理解的是每個(gè)文件夾在運(yùn)行鏈路里的角色。main.py 是服務(wù)端入口雙擊啟動(dòng)腳本之后系統(tǒng)會(huì)跑這個(gè)文件把后端服務(wù)和前端頁面一起拉起來。web 文件夾裝的是前端資源界面上那些節(jié)點(diǎn)菜單、畫布交互、設(shè)置面板靜態(tài)資源基本都在這里。custom_nodes 是第三方插件目錄你在社區(qū)里下載的插件節(jié)點(diǎn)都裝在這。user 目錄存用戶配置和工作流input 管輸入圖片output 管輸出結(jié)果temp 是中間過程文件。這套結(jié)構(gòu)和 SD WebUI 那種“一個(gè) models 打天下”的思路完全不一樣。ComfyUI 的核心理念是模塊化所以目錄劃分也特別細(xì)。你不需要記住每一個(gè)文件夾的作用但至少要能區(qū)分“程序文件”和“數(shù)據(jù)文件”程序文件亂動(dòng)會(huì)導(dǎo)致啟動(dòng)失敗數(shù)據(jù)文件放錯(cuò)位置最多就是加載不到不會(huì)把軟件搞崩。1.2 哪些文件別亂動(dòng)哪些目錄可以隨便刪我把經(jīng)驗(yàn)總結(jié)成三句話。第一根目錄里的核心代碼文件不要碰除非你明確知道自己在改什么。第二temp 目錄可以放心清理ComfyUI 啟動(dòng)時(shí)會(huì)自動(dòng)重建。第三output 目錄會(huì)保存你所有生成結(jié)果想清可以清但重要輸出建議先備份。temp 這個(gè)目錄被很多人忽視但跑起來之后它是最容易膨脹的。你生成一張大尺寸圖片如果步數(shù)又高中間過程會(huì)寫大量臨時(shí)文件到 temp。一些用戶跑了幾個(gè)月temp 能膨脹到幾十 GB磁盤莫名其妙的滿了查來查去最后發(fā)現(xiàn)是這個(gè)目錄在作祟。定期清理 temp 不會(huì)影響任何已保存的圖片因?yàn)樗淮妗斑€在生成過程中”的中間數(shù)據(jù)。還有一點(diǎn)千萬不要把模型文件放在 web 目錄或者程序根目錄下。我見過有人為了方便直接把下載的模型丟在 main.py 旁邊結(jié)果界面加載列表里無論如何都看不到。ComfyUI 只會(huì)掃描指定目錄不會(huì)去全盤搜索模型所以遵守目錄約定是最基本的一步。1.3 input 目錄圖生圖和參考圖的入口input 目錄看著不起眼但它是圖生圖、局部重繪和 ControlNet 參考圖的基礎(chǔ)。在 LoadImage 節(jié)點(diǎn)上你可以點(diǎn)上傳按鈕選擇圖片也可以直接把圖片拖到畫布上ComfyUI 會(huì)自動(dòng)把圖片拷貝進(jìn) input 目錄然后在節(jié)點(diǎn)里填上相對路徑。批量處理素材時(shí)input 目錄特別有用。你把一批圖片按命名規(guī)則丟進(jìn) input然后在 LoadImage 節(jié)點(diǎn)里選擇對應(yīng)文件名就行不用一張張手動(dòng)上傳。要注意的是input 只適合放“這次工作流要用的輸入圖”不適合當(dāng)圖片倉庫。跑完任務(wù)之后及時(shí)清理不然多項(xiàng)目混在一起找圖會(huì)非常痛苦。2. models 模型目錄每個(gè)子文件夾都是給誰準(zhǔn)備的2.1 checkpoints、diffusion_models、unet大模型的三副面孔models 目錄底下才是重頭戲。先從最常用的 checkpoints 說起。SD1.5 和 SDXL 時(shí)代的完整模型safetensors 格式或 ckpt 格式都放在這里L(fēng)oad Checkpoint 節(jié)點(diǎn)加載的就是這些文件。一個(gè) checkpoint 文件就是一個(gè)“全家桶”去噪網(wǎng)絡(luò)、文本編碼器、VAE 全都在里面。你下載的任何 Animate、Anything、RealVisXL 這類大模型直接扔進(jìn) checkpoints 就完事。到了 SD3 和 Flux 時(shí)代情況變了。模型發(fā)布方不再把完整模型打包成一個(gè)文件而是拆成擴(kuò)散模型主體、文本編碼器、VAE 三部分。擴(kuò)散模型主體放在 diffusion_models 目錄文本編碼器放在 text_encodersVAE 放在 vae。如果你下載的是 flux1-dev.safetensors 這類文件要用 Load Diffusion Model 節(jié)點(diǎn)加載而不是 Load Checkpoint。最常見的困惑就在這很多人把 Flux 的拆分包誤放進(jìn) checkpoints然后在 Load Checkpoint 節(jié)點(diǎn)里看不到就以為下載壞了。其實(shí)模型沒壞只是加載器不對。diffusion_models 目錄在官方包自帶的 models 文件夾里可能沒有需要你手動(dòng)新建ComfyUI 會(huì)自動(dòng)識別。同理unet 目錄留給那些只想要去噪網(wǎng)絡(luò)部分的用戶比如從完整模型里抽出 UNet 做融合或者使用社區(qū)轉(zhuǎn)換的 UNet-only 文件。新手大概率用不到 unet 目錄但看到別人工作流里的 Load UNet 節(jié)點(diǎn)時(shí)要能反應(yīng)過來模型應(yīng)該去哪個(gè)文件夾找。2.2 vae、clip、text_encoders拼圖里的其他關(guān)鍵件vae 文件夾存放獨(dú)立 VAE 文件。為什么要單獨(dú)用 VAE因?yàn)橛行?checkpoint 自帶的 VAE 效果一般換一個(gè)更好的 VAE比如常見的 vae-ft-mse-840000能讓寫實(shí)風(fēng)格的細(xì)節(jié)紋理肉眼可見地提升。在 VAE Loader 節(jié)點(diǎn)里掛上獨(dú)立 VAE再連接到 VAE Encode/Decode 節(jié)點(diǎn)替換默認(rèn) VAE 即可。有個(gè)很隱蔽的坑如果你把 VAE 文件放進(jìn)了 checkpoints 目錄而不是 vae 目錄VAE Loader 的選擇列表里就不會(huì)出現(xiàn)它。因?yàn)?ComfyUI 的模型掃描是按目錄嚴(yán)格匹配的不會(huì)出現(xiàn)“你在別處也能看到”的好事。clip 和 text_encoders 這兩個(gè)目錄看著像雙胞胎實(shí)際有時(shí)代差異。舊模型的 CLIP 文本編碼器放在 clip 目錄用于配合 Load CLIP 節(jié)點(diǎn)SD3/Flux 系列的新編碼器則放在 text_encoders 目錄。以 Flux 為例你通常需要下載三個(gè)文件clip_l.safetensors 和 t5xxl_fp8_e4m3fn.safetensors 放到 text_encodersae.safetensors也就是 VAE放到 vae。加載時(shí)用 CLIPLoader 節(jié)點(diǎn)設(shè)置 type 為對應(yīng)類型文件選擇器從 text_encoders 里挑。放錯(cuò)目錄的直接后果是選擇列表空掉或者加載時(shí)報(bào) “CLIP model not found”。2.3 loras、controlnet、embeddings、upscale_models 這些小分類繼續(xù)往下數(shù)這些目錄每個(gè)都有明確用途目錄用途對應(yīng)加載節(jié)點(diǎn)lorasLoRA 微調(diào)模型幾十 MB 到幾百 MBLoraLoadercontrolnetControlNet 模型注意 SD1.5 和 SDXL 版本不能混用ControlNetLoaderembeddings文本反轉(zhuǎn) embedding如 easynegative在 CLIPTextEncode 里直接輸入名稱upscale_models放大模型如 4x-UltraSharp、RealESRGANUpscaleModelLoadergligenGLIGEN 模型用于布局/區(qū)域控制GLIGENLoaderhypernetworks超網(wǎng)絡(luò)文件目前使用頻率較低HypernetworkLoaderstyle_models風(fēng)格模型如 T2I-AdapterStyleModelLoaderphotomakerPhotoMaker 模型用于人像生成PhotoMakerLoader這里重點(diǎn)說兩個(gè)容易被坑的目錄。第一個(gè)是 loras它可以再建子文件夾分類但子文件夾名和文件名的中文命名在某些節(jié)點(diǎn)里可能有兼容問題我自己都是用英文或拼音。第二個(gè)是 controlnetSD1.5 的 ControlNet 和 SDXL 的 ControlNet 文件絕對不能混用你拿 SD1.5 的 ControlNet 去配 SDXL 底?？刂菩Ч苯邮Щ蛘邎?bào)錯(cuò)。下載時(shí)一定要看清文件說明里寫的是哪個(gè)版本。embeddings 目錄使用方式不太一樣。下載的 easynegative.safetensors 放進(jìn) embeddings 之后在正向提示詞或負(fù)向提示詞的 CLIPTextEncode 節(jié)點(diǎn)文本框里直接輸入 easynegative 就能生效。不需要額外加載器也不占用加載節(jié)點(diǎn)這就是 text inversion 的工作方式。2.4 模型文件命名和整理的好習(xí)慣模型文件整理這件事講究一點(diǎn)都不比技術(shù)配置少。我踩過最大的坑就是“文件名隨意化”從各種渠道下載的 LoRA文件名五花八門什么“1111.safetensors”“l(fā)atest_v2.safetensors”過三個(gè)月再想找對應(yīng)觸發(fā)詞根本對不上號?，F(xiàn)在我給自己定了一套規(guī)則文件命名包含模型名、類型、版本三個(gè)要素例如detailed_eyes_lora_v1.safetensors同時(shí)建同名 txt 說明文件里面寫清楚底模版本、觸發(fā)詞、來源鏈接、實(shí)測效果。如果是帶預(yù)覽圖的模型把預(yù)覽圖命名為模型同名 png 放在同目錄加載時(shí)鼠標(biāo)懸停就能看到縮略圖。這套習(xí)慣一開始執(zhí)行覺得繁瑣但模型量超過 100 個(gè)之后真能幫你省下大把時(shí)間。3. 模型放對位置還是不顯示從刷新到加載報(bào)錯(cuò)逐個(gè)排查3.1 最常見的情況放進(jìn)去但沒刷新很多人把模型放進(jìn)文件夾回到 ComfyUI 界面發(fā)現(xiàn)下拉列表里還是老樣子第一反應(yīng)是“壞了是不是要重啟”。其實(shí)大部分時(shí)候只需要點(diǎn)一下模型文件名下拉框旁邊的刷新按鈕。ComfyUI 不會(huì)自動(dòng)監(jiān)聽文件夾變化模型列表是在加載節(jié)點(diǎn)時(shí)讀一次目錄生成的文件放進(jìn)去之后不手動(dòng)刷新列表自然不會(huì)更新。如果點(diǎn)了刷新還沒出現(xiàn)就把整個(gè)瀏覽器頁面刷新一次。瀏覽器端緩存也可能導(dǎo)致下拉列表停留在舊狀態(tài)特別是你長時(shí)間掛著一個(gè) ComfyUI 頁面不關(guān)閉的情況下。刷新頁面不會(huì)影響當(dāng)前工作流畫布放心的刷。3.2 刷新背后的機(jī)制模型列表是“讀一次存一次”模型列表的加載機(jī)制其實(shí)很“笨”節(jié)點(diǎn)渲染時(shí)掃一遍目錄生成下拉選項(xiàng)然后把選項(xiàng)緩存住。你放文件進(jìn)去但沒觸發(fā)重新掃描緩存還是舊的如果是在跑生成任務(wù)的過程中放文件也不能立即看到。所以要養(yǎng)成的習(xí)慣是先放文件再點(diǎn)刷新再選擇模型。如果你用的是整合包有些版本還開了多工作流緩存或模型列表緩存改完目錄后最好重啟一下 ComfyUI 主進(jìn)程再測試。這不是玄學(xué)是緩存機(jī)制決定的。3.3 下載不完整、格式不對、版本錯(cuò)配三個(gè)隱藏深坑排除刷新問題之后模型還是看不到或加載不了就要考慮下面幾個(gè)情況。下載不完整是最常見的問題。瀏覽器下載中途斷網(wǎng)會(huì)生成 .part 或 .crdownload 臨時(shí)文件或者文件顯示有完整大小但校驗(yàn)不通過。一個(gè)只有幾 KB 的 safetensors 文件幾乎可以斷定是沒下完。建議用支持?jǐn)帱c(diǎn)續(xù)傳的下載工具比如 IDM、迅雷或者大的模型直接用 aria2 多線程下載。下載完看一眼文件大小是否和頁面標(biāo)注一致能避免大部分問題。格式不對也是一個(gè)原因。ckpt 是老格式現(xiàn)在很多模型發(fā)布方已經(jīng)轉(zhuǎn)向 safetensors。safetensors 格式更安全加載速度更快優(yōu)先選擇。如果遇到 .bin 或者 .pth 后綴的文件要看清楚節(jié)點(diǎn)是否支持某些節(jié)點(diǎn)只認(rèn) safetensors只認(rèn) safetensors 的場合用 ckpt 就會(huì)直接報(bào)錯(cuò)。版本錯(cuò)配則更隱蔽。ControlNet 的 SD1.5 和 SDXL 版本不能混用LoRA 的底模版本不對也會(huì)導(dǎo)致出圖異常甚至報(bào)錯(cuò)。看到加載器報(bào)錯(cuò)時(shí)先把模型文件從哪個(gè)模型版本下載的確認(rèn)一遍通常能解決一半問題。報(bào)錯(cuò)現(xiàn)象常見原因排查思路下拉列表里找不到文件放錯(cuò)目錄/沒刷新/文件未下載完成檢查目錄、點(diǎn)刷新、核對文件大小文件能看到但加載報(bào)錯(cuò)格式不支持/模型文件損壞換 safetensors 格式、重新下載ControlNet 加載后無效SD1.5 與 SDXL 版本混用核對底模版本對應(yīng)的 ControlNetVAE 加載器里沒有文件誤放到 checkpoints移到 vae 目錄4. 官方版與整合包的差異以及外置模型的正確配置4.1 秋葉整合包的目錄和官方版有什么不一樣秋葉整合包本質(zhì)上是把官方版和一套便攜 Python 環(huán)境、啟動(dòng)器打包在一起核心目錄結(jié)構(gòu)沒有變但頂層會(huì)多出啟動(dòng)器和管理工具。很多用戶搞混的是啟動(dòng)器和 ComfyUI 主程序的位置整合包的模型目錄依然在 ComfyUI\models 里不是包根目錄。啟動(dòng)器負(fù)責(zé)管理 Python 環(huán)境、自動(dòng)更新和目錄配置你在啟動(dòng)器界面上改的模型路徑最終會(huì)寫進(jìn) extra_model_paths 相關(guān)配置。整合包和官方版在 models 目錄內(nèi)部基本一致所以這篇文章講的目錄規(guī)則在兩種版本下都適用。差異主要在于“你是否方便修改配置文件”官方版需要自己手動(dòng)處理 extra_model_paths.yaml整合包一般會(huì)在啟動(dòng)器界面上幫你配置。4.2 用 extra_model_paths.yaml 把模型放到任意盤符如果你不想把所有模型都復(fù)制進(jìn) ComfyUI 的 models 目錄或者你的模型庫存放在獨(dú)立硬盤里可以用 extra_model_paths.yaml 掛載外部路徑。官方版第一次運(yùn)行后會(huì)在根目錄生成 extra_model_paths.yaml.example把它復(fù)制一份重命名為 extra_model_paths.yaml然后按下面的格式編輯other_models: base_path: E:/AI-Models checkpoints: StableDiffusion loras: Lora vae: VAE controlnet: ControlNet upscale_models: Upscale embeddings: Embeddingsbase_path 指向你存放模型的根目錄下面的鍵名對應(yīng) ComfyUI 約定目錄名。比如 E:/AI-Models/StableDiffusion 目錄里的模型ComfyUI 會(huì)把它當(dāng)成 checkpoints 目錄的內(nèi)容來掃描。這樣你不用修改 ComfyUI 本體目錄也能在一個(gè)外部目錄下自由組織模型庫。改完配置一定要重啟 ComfyUI而且不同版本對配置項(xiàng)的解析有細(xì)微差異。如果你修改后發(fā)現(xiàn)某個(gè)子目錄沒被識別檢查一下是不是目錄名和鍵名對應(yīng)錯(cuò)了。保留一份配置備份是好習(xí)慣因?yàn)槟承┱习凇耙绘I更新”之后可能會(huì)重寫覆蓋 yaml 文件。4.3 符號鏈接方案要不要用 mklink如果你用的是整合包啟動(dòng)器可能在每次啟動(dòng)時(shí)覆蓋 extra_model_paths.yaml或者你只是想給某個(gè)子目錄單獨(dú)換個(gè)位置這時(shí)候可以用目錄符號鏈接也就是 mklink。在管理員權(quán)限的命令行里執(zhí)行mklink /D D:\ComfyUI\models\loras\my_lora E:\models\loras\my_lora注意目標(biāo)位置不能已存在同名文件夾鏈接成功后ComfyUI 里看到的就是一個(gè)普通目錄底層文件實(shí)際在另一個(gè)盤符。這個(gè)方案的好處是“零配置”不用改 yaml對整合包特別友好。缺點(diǎn)是遷移時(shí)不熟悉符號鏈接的用戶容易把源文件刪掉導(dǎo)致鏈接失效。所以基本上我只推薦給已經(jīng)理解符號鏈接原理的人。日常使用的話extra_model_paths 方案更透明、更可維護(hù)。5. 目錄遷移與空間整理給 ComfyUI“搬家”的實(shí)戰(zhàn)經(jīng)驗(yàn)5.1 換盤前的準(zhǔn)備工作與遷移步驟模型目錄動(dòng)輒幾十 GB換盤或者給 ComfyUI 換位置最忌諱的是直接剪切整個(gè)目錄然后啟動(dòng)報(bào)錯(cuò)。我遷移過三次總結(jié)出一套比較穩(wěn)的流程。第一步停止 ComfyUI 和啟動(dòng)器進(jìn)程確認(rèn)沒有 Python 進(jìn)程占用模型文件否則復(fù)制過程中文件可能是損壞的。第二步用復(fù)制而不是剪切目標(biāo)磁盤空間要提前確認(rèn)夠用復(fù)制失敗可以重試。第三步大文件校驗(yàn)大的 safetensors 文件要核對哈希值或者至少確認(rèn)文件大小一致。第四步通過 extra_model_paths 或符號鏈接把新路徑指到舊地址不要直接改掉原來的目錄結(jié)構(gòu)。第五步啟動(dòng)后逐個(gè)節(jié)點(diǎn)測試加載不要一次加載一堆模型然后報(bào)錯(cuò)不好定位。全部確認(rèn)正常之后再刪除舊文件。5.2 輸出、臨時(shí)文件、日志的定期清理磁盤空間不夠時(shí)先看三個(gè)地方output、temp、更新備份。output 目錄是生成圖片的倉庫時(shí)間久了能堆好幾個(gè) GB建議定期歸檔。temp 目錄前面說過是中間過程文件可以直接清空。更新備份主要是整合包一鍵更新時(shí)自動(dòng)備份的舊版本文件確認(rèn)不需要回滾后也能刪。清理 output 和 temp 可以寫個(gè)簡單的定時(shí)腳本。Windows 下用 forfiles 命令可以按修改日期批量移動(dòng)文件forfiles /p D:\ComfyUI\output /s /m *.png /d -30 /c cmd /c move path D:\Backup\AI_Output\這條命令把 output 目錄下 30 天之前的 png 文件移到備份目錄。配合 Windows 任務(wù)計(jì)劃程序每個(gè)月自動(dòng)執(zhí)行一次就基本不用手動(dòng)操心磁盤爆滿的問題。注意路徑不要帶空格或者中文不然 forfiles 的轉(zhuǎn)義會(huì)讓人頭大。5.3 磁盤空間規(guī)劃與模型版本管理我的個(gè)人規(guī)劃是系統(tǒng)盤只放 ComfyUI 程序本體和必要的臨時(shí)文件所有模型外置到獨(dú)立的數(shù)據(jù)盤按底模版本建立一級目錄比如 SD15、SDXL、Flux、ControlNet、LoRA。每個(gè)一級目錄下再按模型系列分子目錄。版本管理上我強(qiáng)烈建議不要輕易覆蓋舊模型文件。底模更新后之前調(diào)的 LoRA 可能在新版本上效果不理想你想回退到舊底模卻發(fā)現(xiàn)文件已經(jīng)被覆蓋了那種感覺真的很崩潰。下載模型時(shí)順手在文件名里標(biāo)注版本號配合說明 txt能避免 90% 的版本混亂問題。6. custom_nodes 和 user 目錄兩塊容易被忽視的“模型區(qū)”6.1 插件目錄模型藏在“別人的文件夾”里custom_nodes 目錄下每個(gè)子文件夾就是一個(gè)第三方插件。你在社區(qū)里下載的插件一般通過 git clone 或者手動(dòng)解壓裝到這里。安裝之后基本都需要重啟 ComfyUI 才能生效部分插件還會(huì)在啟動(dòng)時(shí)自動(dòng)從網(wǎng)上下載模型到自己的子目錄里。這也是很多人找不到模型的一個(gè)重要原因有些自定義節(jié)點(diǎn)的模型文件并不在 models 全局目錄而在插件自己的子目錄里。比如某個(gè) ControlNet 輔助插件、某個(gè)修復(fù)插件它們各自有獨(dú)立的模型文件夾。當(dāng)你在全局 models 里找不到某個(gè)模型時(shí)記得去對應(yīng)插件的目錄下翻一翻。插件裝多了之后沖突問題也容易出現(xiàn)。出現(xiàn)啟動(dòng)報(bào)錯(cuò)時(shí)可以先把 custom_nodes 下可疑的插件臨時(shí)改名移出目錄再重啟看是否恢復(fù)。如果恢復(fù)就說明是這個(gè)插件的問題。別急著刪先看更新日志很多時(shí)候升級一下插件版本就解決了。6.2 user 目錄與工作流管理的建議user\default 目錄下主要存用戶配置、快捷鍵設(shè)置、默認(rèn)工作流等。界面布局或設(shè)置丟失時(shí)多半是這里的配置損壞或被還原。我自己一般會(huì)把常用工作流文件另存到工作區(qū)目錄user 目錄只留默認(rèn)設(shè)置這樣即使配置重置也不會(huì)丟失辛苦搭好的工作流。如果你有多臺設(shè)備可以把這個(gè)目錄里的核心配置文件備份到云盤或 Git 倉庫。換機(jī)之后直接放回去能少調(diào)很多界面設(shè)置。這里額外提醒一句不要在工作流文件里寫死絕對路徑除非你確定所有設(shè)備都保持同樣的目錄結(jié)構(gòu)否則換機(jī)器之后路徑必然失效。說到底ComfyUI 的目錄管理就是一套“整理癖”修行。我現(xiàn)在遇到模型不顯示第一反應(yīng)永遠(yuǎn)是按順序排查放對目錄沒有、刷新沒有、文件格式對不對、有沒有中文路徑和特殊字符。這套順序比看任何報(bào)錯(cuò)都管用。最后分享一個(gè)我自己的小技巧每次下載模型時(shí)順手寫一個(gè)說明 txt內(nèi)容就五行——模型來源、底模版本、觸發(fā)詞、測試參數(shù)、下載日期。寫完之后放到模型同目錄。別嫌麻煩等你模型積累到幾百個(gè)的時(shí)候這個(gè)習(xí)慣能幫你省出的時(shí)間比當(dāng)時(shí)下載模型的時(shí)間還多。