为什么要提前规划数据目录

Stable Diffusion WebUI 是目前使用门槛较低的本地 AI 绘图工具。它适合在电脑上生成图片、管理模型、调试提示词的用户。

很多新手首次安装时，会直接把程序解压到系统盘。模型、插件、输出图片也全部默认保存在系统盘。刚开始看似方便，但使用一段时间后，问题就出现了：空间不足、备份困难、重装系统后数据丢失。

一个基础模型通常就有数 GB。后续还会下载 LoRA、VAE、ControlNet 模型、插件和大量生成结果。因此，把 WebUI 程序文件与数据文件分开管理是更稳妥的做法。

程序可以放在一个目录，模型和输出图片放到容量更大的磁盘或专门的数据盘。这样后续升级、回滚、迁移都会更轻松。

安装前需要准备什么

以 Windows 电脑为例，推荐准备以下硬件：

• NVIDIA 独立显卡，显存 6GB 以上体验更好
• 内存建议 16GB 起步
• 磁盘至少预留 50GB 空间。如果计划长期使用，建议准备 200GB 以上的数据目录
• CPU 也能运行，但速度较慢，不适合频繁出图

软件环境方面，建议安装 Python 3.10.6，并在安装时勾选“Add Python to PATH”。同时安装 Git，用于拉取和更新 WebUI 文件。

安装完成后，可在命令提示符中输入 python --version 和 git --version 检查是否可用。若系统已装过多个 Python 版本，建议先确认默认版本，避免启动脚本调用到不兼容版本。

下载 WebUI 时，建议从项目主页获取稳定版本，不要随意使用来路不明的打包版。模型文件也应优先选择可信来源，并留意作者给出的使用许可。涉及人物肖像、品牌元素或商业项目时，要先确认授权范围，避免后续产生纠纷。

基础安装流程

第一步：创建程序目录

在非系统盘创建程序目录，例如 D:AIstable-diffusion-webui。路径尽量使用英文和数字，不要包含中文、特殊符号或过长层级。这能减少依赖安装和插件读取时的异常。

第二步：获取 WebUI 文件

使用 Git 获取 WebUI 文件。在目标目录上级打开命令提示符，执行 git clone 对应项目地址，将文件下载到本地。如果不熟悉命令，也可以下载压缩包后解压，但后续更新会略麻烦。

第三步：准备模型文件

基础模型通常放在 webui 目录下的 modelsStable-diffusion 文件夹中。文件扩展名常见为 .safetensors 或 .ckpt。新手更推荐使用 .safetensors 格式，安全性和管理体验更好。

首次启动前至少放入一个基础模型，否则界面能打开但无法正常生成图片。

第四步：启动 WebUI

双击 webui-user.bat 启动。首次运行会自动下载依赖，耗时取决于网络和电脑性能。安装过程不要频繁关闭窗口。看到本地访问地址后，再用浏览器打开即可进入界面。

若中途报错，先不要重复乱改文件。应记录完整报错信息，再按原因处理。

数据目录迁移的推荐方案

全新安装：从第一天设置独立数据目录

最推荐的方法是：创建独立数据目录，例如 E:SDData。在其中建立 models、outputs、extensions、embeddings 等文件夹。这样 WebUI 主程序与数据分开，后续删除或替换程序目录时，不会误删重要素材。

常见做法是在 webui-user.bat 中设置启动参数。右键该文件选择编辑，找到 set COMMANDLINE_ARGS= 这一行，在后面添加 --data-dir "E:SDData"。保存后重新启动，WebUI 会把可变数据指向该目录。

路径建议不要放在桌面、下载文件夹或同步盘目录中，避免权限、占用和自动同步导致文件损坏。

已有数据：迁移旧数据的步骤

如果已经使用了一段时间，需要迁移旧数据，可按以下顺序操作：

1. 关闭 WebUI，确认命令行窗口已经退出
2. 备份原目录中的 models、outputs、embeddings、extensions、config.json、ui-config.json 等关键内容
3. 复制模型和输出图片到新的 E:SDData 对应目录
4. 修改 webui-user.bat 的 --data-dir 参数并重新启动
5. 确认模型能加载、历史输出能找到、插件能正常显示后，再考虑清理旧目录

只迁移部分数据（进阶用法）

有些用户只想迁移模型，不想迁移全部数据。可以使用更细的参数，例如：

• --ckpt-dir 指向基础模型目录
• --vae-dir 指向 VAE 目录
• --lora-dir 指向 LoRA 目录
• --embeddings-dir 指向嵌入文件目录

这种方式适合已有统一模型库的用户，但参数较多，新手维护成本更高。若没有特殊需求，使用 --data-dir 更省心。

使用目录链接的替代办法

当某些插件仍然默认读取原路径时，可以考虑使用目录链接。让系统把旧位置映射到新位置。Windows 下常见方式是使用 mklink /J 创建目录联接。

例如：把原来的 models 文件夹移到 E:SDDatamodels 后，在原位置建立指向新目录的联接。这样 WebUI 看起来仍在访问旧目录，实际文件保存在新磁盘。

这种方法兼容性较好，但操作前必须确认原文件夹已完整复制并改名备份，避免误覆盖。命令需要在命令提示符中执行，路径要写准确。若不熟悉命令行，优先使用 --data-dir 参数，不建议一边改启动参数，一边建立多个目录链接，否则排查问题会变复杂。

迁移后的检查清单

迁移完成后，不要急着删除旧文件。建议先检查以下五项内容：

• 模型下拉框是否能看到基础模型
• LoRA 面板是否能正常刷新
• 生成图片是否保存到新 outputs 目录
• 插件页面是否能正常加载
• 设置项修改后重启是否仍然生效

如果这些都正常，再保留旧目录几天作为备份。确认无误后再清理。

还要注意磁盘格式和权限。部分外接盘或老旧分区对大文件支持不好，可能导致模型复制失败。数据目录不要放在需要频繁插拔的移动设备上，否则启动时找不到路径会报错。多人共用电脑时，建议给数据目录设置清晰的访问权限，并避免把私人项目素材混在公共目录。

常见问题汇总

问题一：启动时提示 Python 版本不匹配

通常是电脑里存在多个 Python，WebUI 调用了较新或较旧的版本。解决办法：安装推荐版本，并检查环境变量；必要时在 webui-user.bat 中指定 Python 路径。

问题二：首次启动一直下载失败

可能是依赖源访问不稳定或安全软件拦截。可以稍后重试，或检查防护软件日志，确认没有误拦截 python、git、webui 目录。不要随意下载不明依赖包替换系统文件。

问题三：显存不足或生成速度很慢

可尝试降低分辨率、减少批量数量。启动参数中加入 --medvram 或 --lowvram。显存较小的设备不要一开始就使用超高分辨率和多个控制插件，先保证基础出图稳定。

问题四：迁移后模型列表为空

先检查 --data-dir 路径是否写错，再确认模型是否放在 E:SDDatamodelsStable-diffusion 之类的正确目录中。注意文件夹名称大小写一般不敏感，但层级错误会导致识别失败。

问题五：插件不见了或报错

部分插件依赖固定路径或额外模型。先进入扩展页面检查是否安装完整，再查看命令行报错。若是从旧目录复制 extensions，建议逐个启用排查，不要一次性安装大量插件。

问题六：生成图片仍保存在旧目录

进入设置页面查看保存路径相关选项，确认没有手动指定旧 outputs 路径。修改后点击保存设置并重启 WebUI。有时界面设置会覆盖启动参数，需要以实际保存位置为准。

升级、回滚与备份建议

WebUI 更新前，建议先备份以下文件：webui-user.bat、config.json、ui-config.json、styles.csv，以及数据目录中的重要模型和输出结果。插件较多的用户还应记录当前可用版本。

更新后如果出现异常，可以先禁用新增插件，再考虑回退到之前的程序版本。

数据目录迁移的核心原则是：先复制、再验证、后删除。不要在没有备份的情况下直接剪切全部文件，也不要把唯一模型库放在不稳定磁盘中。对于商业项目或长期作品，建议定期把提示词、参数、工程说明和最终图片一起归档，单纯保存图片不利于复现。

安全边界与实用建议

Stable Diffusion WebUI 本身是工具，真正影响风险的是模型来源、插件权限和使用方式。安装插件前应查看项目说明、更新记录和用户反馈，避免运行来历不清的脚本。

不要把含有隐私信息的素材随意导入不可信扩展，也不要把未授权素材用于公开传播或商业交付。

对新手来说，最稳的路径是：

1. 先完成基础安装
2. 再设置独立数据目录
3. 只放一个可靠基础模型测试出图
4. 确认稳定后，再逐步增加 LoRA、VAE、ControlNet 等组件

每增加一类扩展，都记录安装时间和修改内容。这样即使遇到报错，也能快速定位问题，而不是从头重装。

只要目录规划清楚、备份习惯到位，Stable Diffusion WebUI 的安装和迁移并不复杂。把程序、模型、输出、插件分层管理，既能节省系统盘空间，也能让后续升级维护更可控。对于刚入门的用户，这一步看似麻烦，却能避免以后大规模整理文件的成本。