[{"data":1,"prerenderedAt":833},["ShallowReactive",2],{"content-/zh/basic-tutorial/filesystem":3},{"id":4,"title":5,"body":6,"description":70,"extension":826,"meta":827,"navigation":828,"path":829,"seo":830,"stem":831,"__hash__":832},"content/zh/basic-tutorial/filesystem.md","Filesystem",{"type":7,"value":8,"toc":809},"minimark",[9,14,27,30,48,51,55,63,171,173,177,186,193,207,356,366,378,381,387,415,417,425,432,437,448,452,477,482,505,507,515,522,576,580,588,590,598,604,608,627,633,635,639,687,689,693,738,740,744,805],[10,11,13],"h2",{"id":12},"_1-核心概念comfyui-如何使用文件","1. 核心概念：ComfyUI 如何使用文件",[15,16,17,18,22,23,26],"p",{},"ComfyUI 是一款",[19,20,21],"strong",{},"基于节点的 Stable Diffusion 工具","，它依靠结构清晰的文件系统来加载模型、保存生成结果、运行扩展功能。\n所有文件都存放在 ",[19,24,25],{},"ComfyUI 主文件夹","（下载解压后得到的文件夹）内。",[15,28,29],{},"文件系统遵循两条简单规则：",[31,32,33,41],"ul",{},[34,35,36,37,40],"li",{},"ComfyUI 会",[19,38,39],{},"自动扫描指定文件夹","来识别模型/节点（大部分文件无需手动关联）。",[34,42,43,44,47],{},"你只需要把文件放到",[19,45,46],{},"正确的子文件夹","里，基础使用无需复杂配置。",[49,50],"hr",{},[10,52,54],{"id":53},"_2-comfyui-完整文件结构自上而下","2. ComfyUI 完整文件结构（自上而下）",[15,56,57,58,62],{},"以下是 Windows 标准目录结构（macOS/Linux 基本一致，只是没有 ",[59,60,61],"code",{},".exe"," 这类文件）。",[64,65,71],"pre",{"className":66,"code":67,"language":68,"meta":69,"style":70},"language-plain shiki shiki-themes github-light github-dark","ComfyUI/\n├── models/                  # 核心：所有 AI 模型（大模型、LoRA、VAE 等）\n    ├── checkpoints/\n    ├── diffusion_models/\n    ├── unet/\n    ├── vae/\n    ├── loras/\n    ├── text_encoders/\n    ......\n├── custom_nodes/            # 扩展：已安装的自定义节点（额外功能）\n├── outputs/                 # 存储：生成的图片、日志、元数据\n├── config/                  # 设置：ComfyUI 配置文件\n├── main.py                  # 启动脚本（不使用 exe 时运行）\n├── ComfyUI.exe              # Windows 一键启动器（整合包版本）\n├── requirements.txt         # 依赖列表（手动安装时用）\n└── web/                     # 内部：前端界面文件（不懂不要修改）\n","plain","text","",[59,72,73,81,87,93,99,105,111,117,123,129,135,141,147,153,159,165],{"__ignoreMap":70},[74,75,78],"span",{"class":76,"line":77},"line",1,[74,79,80],{},"ComfyUI/\n",[74,82,84],{"class":76,"line":83},2,[74,85,86],{},"├── models/                  # 核心：所有 AI 模型（大模型、LoRA、VAE 等）\n",[74,88,90],{"class":76,"line":89},3,[74,91,92],{},"    ├── checkpoints/\n",[74,94,96],{"class":76,"line":95},4,[74,97,98],{},"    ├── diffusion_models/\n",[74,100,102],{"class":76,"line":101},5,[74,103,104],{},"    ├── unet/\n",[74,106,108],{"class":76,"line":107},6,[74,109,110],{},"    ├── vae/\n",[74,112,114],{"class":76,"line":113},7,[74,115,116],{},"    ├── loras/\n",[74,118,120],{"class":76,"line":119},8,[74,121,122],{},"    ├── text_encoders/\n",[74,124,126],{"class":76,"line":125},9,[74,127,128],{},"    ......\n",[74,130,132],{"class":76,"line":131},10,[74,133,134],{},"├── custom_nodes/            # 扩展：已安装的自定义节点（额外功能）\n",[74,136,138],{"class":76,"line":137},11,[74,139,140],{},"├── outputs/                 # 存储：生成的图片、日志、元数据\n",[74,142,144],{"class":76,"line":143},12,[74,145,146],{},"├── config/                  # 设置：ComfyUI 配置文件\n",[74,148,150],{"class":76,"line":149},13,[74,151,152],{},"├── main.py                  # 启动脚本（不使用 exe 时运行）\n",[74,154,156],{"class":76,"line":155},14,[74,157,158],{},"├── ComfyUI.exe              # Windows 一键启动器（整合包版本）\n",[74,160,162],{"class":76,"line":161},15,[74,163,164],{},"├── requirements.txt         # 依赖列表（手动安装时用）\n",[74,166,168],{"class":76,"line":167},16,[74,169,170],{},"└── web/                     # 内部：前端界面文件（不懂不要修改）\n",[49,172],{},[10,174,176],{"id":175},"_3-关键文件夹详细说明","3. 关键文件夹详细说明",[178,179,181,182,185],"h3",{"id":180},"_31-models-comfyui-的大脑","3.1 ",[59,183,184],{},"models/"," —— ComfyUI 的“大脑”",[15,187,188,189,192],{},"这是",[19,190,191],{},"最重要的文件夹","，存放所有用于图像生成的 AI 模型。\nComfyUI 会自动扫描这里的子文件夹，只要放对位置，模型就会出现在节点菜单里。",[15,194,195,198,199,202,203,206],{},[19,196,197],{},"千万不要重命名系统自带子文件夹","（比如不要把 ",[59,200,201],{},"checkpoints"," 改成 ",[59,204,205],{},"models","），否则 ComfyUI 无法识别。",[208,209,210,226],"table",{},[211,212,213],"thead",{},[214,215,216,220,223],"tr",{},[217,218,219],"th",{},"子文件夹名称",[217,221,222],{},"这里放什么",[217,224,225],{},"重要说明",[227,228,229,251,271,284,300,317,330,343],"tbody",{},[214,230,231,237,248],{},[232,233,234],"td",{},[59,235,236],{},"checkpoints/",[232,238,239,240,243,244,247],{},"Stable Diffusion 大模型（如 ",[59,241,242],{},"v1-5-pruned-emaonly.safetensors","、",[59,245,246],{},"Flux1-dev.safetensors","）",[232,249,250],{},"完整模型，自带 CLIP 和 VAE，现在已较少单独使用",[214,252,253,258,264],{},[232,254,255],{},[59,256,257],{},"diffusion_models/",[232,259,260,261,247],{},"扩散模型（如 ",[59,262,263],{},"z-image-turbo",[232,265,266,267,270],{},"用于图像生成，",[19,268,269],{},"不包含"," CLIP 或 VAE",[214,272,273,278,281],{},[232,274,275],{},[59,276,277],{},"unet/",[232,279,280],{},"UNet 模型",[232,282,283],{},"负责图像生成核心计算，部分大模型已自带 UNet",[214,285,286,291,297],{},[232,287,288],{},[59,289,290],{},"vae/",[232,292,293,294,247],{},"VAE 模型（如 ",[59,295,296],{},"vae-ft-mse-840000-ema-pruned.safetensors",[232,298,299],{},"改善色彩与画质，部分模型已自带",[214,301,302,307,310],{},[232,303,304],{},[59,305,306],{},"loras/",[232,308,309],{},"LoRA 模型（风格/角色微调，体积小）",[232,311,312,313,316],{},"轻量级，配合 ",[59,314,315],{},"Apply LoRA"," 节点使用",[214,318,319,324,327],{},[232,320,321],{},[59,322,323],{},"embeddings/",[232,325,326],{},"文本反转/嵌入（如 EasyNegative）",[232,328,329],{},"用于提示词/负面提示词，现在使用较少",[214,331,332,337,340],{},[232,333,334],{},[59,335,336],{},"controlnet/",[232,338,339],{},"ControlNet 模型",[232,341,342],{},"控制构图、姿态、边缘、深度等",[214,344,345,350,353],{},[232,346,347],{},[59,348,349],{},"upscale_models/",[232,351,352],{},"高清放大模型",[232,354,355],{},"无损放大图片，配合放大节点使用",[15,357,358,361,362,365],{},[19,359,360],{},"专业小技巧","：\n你可以在这些文件夹里",[19,363,364],{},"再建子文件夹","分类，例如：",[31,367,368,373],{},[34,369,370],{},[59,371,372],{},"models/loras/anime/",[34,374,375],{},[59,376,377],{},"models/checkpoints/flux/",[15,379,380],{},"ComfyUI 依然能正常识别，方便你管理大量模型。",[15,382,383,386],{},[19,384,385],{},"重要注意","：",[31,388,389,399,409],{},[34,390,391,392,394,395,398],{},"放在 ",[59,393,201],{}," 里的模型，通常",[19,396,397],{},"自带 UNet + VAE","（老模型如 SDXL 尤其如此）。",[34,400,391,401,404,405,408],{},[59,402,403],{},"diffusion_models"," 里的模型，",[19,406,407],{},"一般不带 UNet 或 VAE","。",[34,410,411,412,408],{},"把模型拆分成扩散模型、VAE、UNET，是为了获得",[19,413,414],{},"更好的生成效果",[49,416],{},[178,418,420,421,424],{"id":419},"_32-custom_nodes-扩展-comfyui-功能","3.2 ",[59,422,423],{},"custom_nodes/"," —— 扩展 ComfyUI 功能",[15,426,427,428,431],{},"这个文件夹存放",[19,429,430],{},"自定义节点","，相当于插件，可以给 ComfyUI 增加新功能：\n新采样器、图片处理器、IP-Adapter、工具联动等。",[433,434,436],"h4",{"id":435},"使用方法","使用方法：",[438,439,440,445],"ol",{},[34,441,442,443,408],{},"下载自定义节点（ZIP 或 Git 仓库），解压/复制到 ",[59,444,423],{},[34,446,447],{},"重启 ComfyUI，新节点就会出现在节点菜单里（可用搜索快速找到）。",[433,449,451],{"id":450},"示例结构","示例结构：",[64,453,455],{"className":66,"code":454,"language":68,"meta":69,"style":70},"custom_nodes/\n├── ComfyUI-IP-Adapter/      # 图片引导生成\n├── ComfyUI-Custom-Samplers/ # 新采样方法\n└── ComfyUI-Image-Utils/     # 图片编辑工具（裁剪、缩放等）\n",[59,456,457,462,467,472],{"__ignoreMap":70},[74,458,459],{"class":76,"line":77},[74,460,461],{},"custom_nodes/\n",[74,463,464],{"class":76,"line":83},[74,465,466],{},"├── ComfyUI-IP-Adapter/      # 图片引导生成\n",[74,468,469],{"class":76,"line":89},[74,470,471],{},"├── ComfyUI-Custom-Samplers/ # 新采样方法\n",[74,473,474],{"class":76,"line":95},[74,475,476],{},"└── ComfyUI-Image-Utils/     # 图片编辑工具（裁剪、缩放等）\n",[15,478,479,386],{},[19,480,481],{},"重要提醒",[31,483,484,495],{},[34,485,486,487,490,491,494],{},"部分节点需要额外依赖，请看节点里的 ",[59,488,489],{},"README.md","，用 ",[59,492,493],{},"pip install"," 安装。",[34,496,497,498,501,502,408],{},"如果节点加载失败，看控制台报错，通常是",[19,499,500],{},"缺依赖","或",[19,503,504],{},"版本不兼容",[49,506],{},[178,508,510,511,514],{"id":509},"_33-outputs-保存你的作品","3.3 ",[59,512,513],{},"outputs/"," —— 保存你的作品",[15,516,517,518,521],{},"这个文件夹保存",[19,519,520],{},"所有生成的图片","及其元数据（提示词、参数、Seed 等），ComfyUI 会自动分类建文件夹。",[208,523,524,534],{},[211,525,526],{},[214,527,528,531],{},[217,529,530],{},"子文件夹",[217,532,533],{},"内容",[227,535,536,546,556,566],{},[214,537,538,543],{},[232,539,540],{},[59,541,542],{},"outputs/img2img/",[232,544,545],{},"图生图生成的图片",[214,547,548,553],{},[232,549,550],{},[59,551,552],{},"outputs/txt2img/",[232,554,555],{},"文生图生成的图片",[214,557,558,563],{},[232,559,560],{},[59,561,562],{},"outputs/extras/",[232,564,565],{},"其他工作流（放大、局部重绘等）",[214,567,568,573],{},[232,569,570],{},[59,571,572],{},"outputs/logs/",[232,574,575],{},"日志文件（排错非常有用）",[433,577,579],{"id":578},"核心特点","核心特点：",[31,581,582,585],{},[34,583,584],{},"文件名带时间戳，不会覆盖旧图。",[34,586,587],{},"图片内嵌生成信息，可在 ComfyUI 内或 ExifTool 查看。",[49,589],{},[178,591,593,594,597],{"id":592},"_34-config-调整-comfyui-设置","3.4 ",[59,595,596],{},"config/"," —— 调整 ComfyUI 设置",[15,599,600,601,408],{},"存放配置文件，新手一般只需要用到 ",[59,602,603],{},"config.py",[433,605,607],{"id":606},"常用修改","常用修改：",[31,609,610,617,624],{},[34,611,612,613,616],{},"修改默认输出目录：把 ",[59,614,615],{},"output_directory = \"outputs\""," 改成自定义路径。",[34,618,619,620,623],{},"开启 CUDA 加速：确保 ",[59,621,622],{},"cuda = True","（大幅提速）。",[34,625,626],{},"调整图片格式、压缩率等。",[15,628,629,632],{},[19,630,631],{},"警告","：不懂代码不要乱改其他文件，会直接导致 ComfyUI 无法启动。",[49,634],{},[178,636,638],{"id":637},"_35-其他不太重要的文件","3.5 其他不太重要的文件",[208,640,641,651],{},[211,642,643],{},[214,644,645,648],{},[217,646,647],{},"文件名",[217,649,650],{},"作用",[227,652,653,667,677],{},[214,654,655,660],{},[232,656,657],{},[59,658,659],{},"main.py",[232,661,662,663,666],{},"Python 主启动文件，用 ",[59,664,665],{},"python main.py"," 启动",[214,668,669,674],{},[232,670,671],{},[59,672,673],{},"ComfyUI.exe",[232,675,676],{},"Windows 一键启动器",[214,678,679,684],{},[232,680,681],{},[59,682,683],{},"requirements.txt",[232,685,686],{},"Python 依赖清单，缺失模块时安装",[49,688],{},[10,690,692],{"id":691},"_4-文件管理最佳实践避坑必备","4. 文件管理最佳实践（避坑必备）",[438,694,695,704,712,718,724],{},[34,696,697,700,701,703],{},[19,698,699],{},"按类别分类模型","：在 ",[59,702,184],{}," 内建子文件夹，查找更快。",[34,705,706,386,709,711],{},[19,707,708],{},"定期清理输出文件夹",[59,710,513],{}," 会越来越大。",[34,713,714,717],{},[19,715,716],{},"备份自定义节点","：重装系统/软件时很有用。",[34,719,720,723],{},[19,721,722],{},"优先用 safetensors 格式","：比 ckpt 更安全、加载更快。",[34,725,726,386,729,243,731,243,734,737],{},[19,727,728],{},"不要重命名核心系统文件夹",[59,730,205],{},[59,732,733],{},"custom_nodes",[59,735,736],{},"outputs"," 不能改名。",[49,739],{},[10,741,743],{"id":742},"_5-文件相关常见问题排查","5. 文件相关常见问题排查",[208,745,746,759],{},[211,747,748],{},[214,749,750,753,756],{},[217,751,752],{},"问题",[217,754,755],{},"原因",[217,757,758],{},"解决方法",[227,760,761,772,783,794],{},[214,762,763,766,769],{},[232,764,765],{},"模型在 ComfyUI 里不显示",[232,767,768],{},"放错文件夹",[232,770,771],{},"放到对应文件夹并重启 ComfyUI",[214,773,774,777,780],{},[232,775,776],{},"自定义节点加载失败",[232,778,779],{},"缺依赖 / 版本不兼容",[232,781,782],{},"按 README 安装依赖，更新 ComfyUI",[214,784,785,788,791],{},[232,786,787],{},"图片不保存",[232,789,790],{},"文件夹无写入权限",[232,792,793],{},"Windows 以管理员运行，或修改文件夹权限",[214,795,796,799,802],{},[232,797,798],{},"启动就崩溃",[232,800,801],{},"模型损坏 / 显存不足",[232,803,804],{},"删除损坏模型，关闭占用显存的软件",[806,807,808],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":70,"searchDepth":83,"depth":83,"links":810},[811,812,813,824,825],{"id":12,"depth":83,"text":13},{"id":53,"depth":83,"text":54},{"id":175,"depth":83,"text":176,"children":814},[815,817,819,821,823],{"id":180,"depth":89,"text":816},"3.1 models/ —— ComfyUI 的“大脑”",{"id":419,"depth":89,"text":818},"3.2 custom_nodes/ —— 扩展 ComfyUI 功能",{"id":509,"depth":89,"text":820},"3.3 outputs/ —— 保存你的作品",{"id":592,"depth":89,"text":822},"3.4 config/ —— 调整 ComfyUI 设置",{"id":637,"depth":89,"text":638},{"id":691,"depth":83,"text":692},{"id":742,"depth":83,"text":743},"md",{},true,"/zh/basic-tutorial/filesystem",{"description":70},"zh/basic-tutorial/filesystem","QO5_d8ak6MQ-o4YL_8Io4LJepb4-AUgUMXJ896u3ERg",1773986044745]