ControlNet 适合解决什么问题
ControlNet 是 Stable Diffusion 生态中广泛使用的条件控制组件，能够显著提升生成结果的可控性。普通文生图主要依赖提示词，人物姿态、画面构图、物体边缘往往不稳定；引入 ControlNet 后，可通过姿态图、线稿、深度图、边缘图等额外约束，使模型按照指定结构生成画面。对新手而言，它最适合三类场景：参照人物动作生成新图、将草图转化为完整插画、保持建筑或商品轮廓进行风格迁移。
安装前需要明确：ControlNet 并非独立绘图软件，而是配合 Stable Diffusion WebUI 或类似前端使用的扩展插件。免费方案通常是在本地电脑运行，优点在于可控性强、成本低、便于反复调试；缺点是对显卡显存、磁盘容量及环境配置有一定要求。若电脑配置较低，也可先安装轻量模型，仅做小尺寸测试，确认流程无误后再扩展模型库。
安装前准备：硬件、软件与目录规划
建议硬件配置为：显存 6GB 起步，8GB 以上体验更佳；内存建议 16GB 以上；磁盘预留至少 30GB，如需下载多个 ControlNet 模型，最好准备 80GB 以上空间。系统可使用 Windows、macOS 或 Linux，新手更推荐 Windows，因为图形界面教程丰富，排错资料也更容易找到。
软件方面，需提前安装 Python、Git、Stable Diffusion WebUI 以及一个可用的基础绘图模型。若已能正常打开 WebUI 并完成一次文生图，说明基础环境基本就绪，再安装 ControlNet 会更稳妥。目录规划同样重要，默认安装常将扩展、模型、缓存全放在同一盘符，时间久了容易占满空间。建议从一开始建立清晰结构，例如：AI主目录、models目录、outputs目录、cache目录，将大体积文件统一存放到容量更大的磁盘中。
免费安装方案：通过 WebUI 扩展安装
最常见的免费安装方式是通过 Stable Diffusion WebUI 的扩展管理进行安装。先启动 WebUI，进入 Extensions 页面，选择 Install from URL，在扩展地址栏填写 ControlNet 对应的开源项目地址，然后点击 Install。安装完成后，切换到 Installed 页面点击 Apply and restart UI，等待界面重启。若页面底部或文生图界面出现 ControlNet 面板，说明扩展已成功加载。
如果扩展安装后未显示，先检查 WebUI 启动窗口是否有红色报错。常见原因包括 Python 包依赖未安装完整、扩展目录不完整、WebUI 版本过旧。新手不建议同时安装大量扩展，因为不同扩展可能修改相同依赖，排错会变得复杂。较稳妥的顺序是：先确认 WebUI 能正常出图，再安装 ControlNet，再下载一个控制模型进行测试。
模型文件放在哪里：ControlNet 数据目录迁移
ControlNet 的核心占用主要来自模型文件，例如姿态控制、线稿控制、深度控制、边缘控制等模型。默认路径通常位于 WebUI 目录下的 extensions/sd-webui-controlnet/models。随着模型增多，该目录可能迅速膨胀，因此建议将 ControlNet 模型目录迁移至大容量磁盘。
迁移思路有两种。第一种是直接在 ControlNet 设置中修改模型路径。进入 WebUI 的 Settings，找到 ControlNet 相关设置项，将 Model directory 设置为新路径，例如 D:/AIModels/ControlNet，然后保存设置并重启 WebUI。将原 models 目录下的模型文件复制到新目录，重启后在 ControlNet 面板刷新模型列表即可。
第二种是使用系统目录链接，让 WebUI 仍认为模型在原路径，实际文件存放于新磁盘。此方法适合不想改动软件配置的用户，但需谨慎操作。操作前先关闭 WebUI，备份原 models 目录；再将模型文件移动到新位置；最后建立从原路径指向新路径的目录链接。完成后重新启动 WebUI，若模型列表正常显示，说明迁移成功。新手更推荐第一种方式，直观且可恢复，出问题时只需将路径改回即可。
推荐下载哪些 ControlNet 模型
新手不必一次下载全部模型，先准备三个最常用的即可。第一是 OpenPose 类模型，用于控制人物姿态，适合人像、角色设计及动作一致性测试。第二是 Canny 类模型，用于依据边缘线生成画面，适合将参考图转换为不同风格。第三是 Depth 类模型，用于保留空间层次和前后关系，适合室内、建筑、产品场景。
下载模型时需注意文件名和扩展名，常见格式包括 safetensors、pth、yaml 等。优先选择来源清晰、下载量较高、说明完整的模型文件，不要随意运行来历不明的脚本。模型文件放入指定目录后，返回 WebUI 刷新 ControlNet 模型列表。如果列表未出现，检查路径是否写错、文件是否被放入多层子目录，以及扩展是否需要重启。
基础配置参数：先用稳定值跑通流程
第一次测试不建议追求高分辨率和复杂提示词，目标是验证 ControlNet 是否生效。推荐参数如下：采样步数 20 到 28，采样器可选 DPM++ 2M Karras 或 Euler a，宽高先设为 512×512 或 512×768，CFG Scale 设置为 6 到 8，Control Weight 设置为 0.8 到 1.0，Starting Control Step 设为 0，Ending Control Step 设为 1。这样控制会贯穿整个生成过程，便于观察效果。
Preprocessor 是预处理器，Model 是控制模型，两者需尽量匹配。例如使用 openpose 预处理器时，模型也应选择 openpose；使用 canny 预处理器时，模型选择 canny；使用 depth 预处理器时，模型选择 depth。可以开启 Pixel Perfect，它会自动匹配预处理分辨率，对新手比较友好。Resize Mode 可先选 Crop and Resize 或 Just Resize，若参考图构图被裁掉，再调整宽高比例。
测试方法：用一张参考图确认是否生效
测试时准备一张结构清晰的参考图，例如站立人物、简单室内图或线条明确的物体图。进入文生图页面，展开 ControlNet 面板，勾选 Enable，上传参考图，选择对应预处理器和模型。提示词可以写得简单，例如“高质量插画、清晰细节、自然光照、完整人物”，反向提示词可加入“低清晰度、畸形、额外肢体、模糊”。点击预览预处理结果，如果能显示骨架、边缘或深度图，说明预处理正常。
生成第一张图后，重点观察三件事：一是姿态或轮廓是否与参考图一致；二是画面风格是否受提示词影响；三是有无明显结构错误。如果完全不受控制，通常是 Enable 未勾选、模型与预处理器不匹配、Control Weight 太低，或模型目录未正确加载。如果控制过强导致画面僵硬，可将 Control Weight 降到 0.55 到 0.75，或将 Ending Control Step 调到 0.7 左右，让后半程有更多发挥空间。
常见问题与排查建议
问题一：ControlNet 面板不显示。先确认扩展安装成功并已重启 WebUI，再查看启动日志是否有依赖报错。必要时更新 WebUI 和扩展，但不要在项目进行中随意升级所有组件，建议先备份。
问题二：模型列表为空。检查 ControlNet 模型目录是否设置正确，模型文件是否放在指定文件夹内，文件名是否包含异常字符。迁移目录后，需重新启动 WebUI，单纯刷新页面有时不够。
问题三：显存不足。降低出图尺寸，减少批量数量，关闭暂时不用的扩展；也可使用较小的基础模型进行测试。不要一开始就开启高分辨率修复、多 ControlNet 单元和大批量生成，这会显著增加资源占用。
问题四：生成图与参考图差异太大。检查预处理结果是否清晰，必要时换一张参考图。Canny 可调整阈值，阈值过低会捕捉太多杂线，过高会丢失结构；OpenPose 对遮挡、多人、复杂背景更敏感，测试阶段建议使用主体清晰的图片。
安全边界与使用建议
ControlNet 能提升可控性，但不等于可以无边界使用。使用参考图时，应确认素材来源可靠，避免将他人作品、人物照片或商业素材直接用于不合适的公开用途。企业团队使用时，建议建立素材登记、模型来源记录和输出审核流程，防范后续版权和合规风险。
从工程角度看，最实用的做法是建立“最小可用配置”：一个稳定的 WebUI 版本、三个常用 ControlNet 模型、一个固定输出目录、一套测试提示词。每次新增模型或扩展前先备份配置文件，并记录变更时间。这样即使升级后出现问题，也能快速回退到可用状态。对于新手而言，先跑通安装、迁移、参数测试这条主线，比一次性追求复杂工作流更可靠。
