企业官网建设流程全解析

SDXL-VAE-FP16-Fix安装完整教程：Stable Diffusion WebUI三步配置与--no-half-vae移除指南

【免费下载链接】sdxl-vae-fp16-fix项目地址: https://ai.gitcode.com/hf_mirrors/madebyollin/sdxl-vae-fp16-fix

SDXL-VAE-FP16-Fix 是一个修复版 SDXL VAE 模型，让 SDXL 的 VAE（变分自编码器）在 fp16 半精度下正常解码，不再产生 NaN（黑图/雪花图）。本教程将手把手教你在 Stable Diffusion WebUI（Automatic1111）中完成 3 步配置，并安全移除--no-half-vae启动参数，从而释放显存、加快出图速度。

一、你是否遇到了 SDXL 出图全黑问题？🔍

如果你使用 SDXL 模型时出现过以下现象，大概率就是 VAE fp16 精度问题：

• 生成图片是纯黑、纯白或雪花噪点
• 控制台报错出现NaN、Inf或 VAE decode 异常
• 加了--no-half-vae参数后能出图，但显存占用明显升高

上图就是原始 SDXL VAE 在 float16 精度下解码的结果——整张图片全是 NaN 值，显示为纯黑色。

二、为什么会这样？30 秒看懂原理

SDXL 原版 VAE 内部激活值过大，超出了 fp16 的数值范围，解码时产生 NaN。下面的图直观展示了网络各层的激活值：可以看到越靠近输出层，数值越大，最终在h_1、h_0等层直接溢出为inf/nan。

SDXL-VAE-FP16-Fix 的解决思路很简单：

1. 微调 SDXL VAE，保持最终输出基本不变；
2. 缩小网络内部的激活值；
3. 方法是对网络中的权重和偏置进行等比缩放。

修复后 VAE 的模型结构完全不变（仍是标准AutoencoderKL），你可以查看 config.json 确认结构参数与原版一致。

三、SDXL-VAE-FP16-Fix 下载方法（两种任选）

方法一：直接下载模型文件

从仓库中找到 sdxl.vae.safetensors 文件下载即可。仓库中也提供了同内容的 sdxl_vae.safetensors 备用命名。

方法二：git clone 整个仓库

如果网络环境无法直接下载文件，可克隆仓库：

git clone https://gitcode.com/hf_mirrors/madebyollin/sdxl-vae-fp16-fix

然后从克隆目录中取出 sdxl.vae.safetensors。

四、Stable Diffusion WebUI 三步配置教程 ⚙️

第 1 步：将 VAE 文件放入指定目录

把下载好的sdxl.vae.safetensors移动到 WebUI 根目录下的 VAE 模型文件夹：

stable-diffusion-webui/models/VAE/sdxl.vae.safetensors

小技巧：文件命名保持sdxl.vae.safetensors即可，WebUI 会自动扫描该目录识别 VAE。

第 2 步：在设置中选中修复版 VAE

1. 打开 WebUI，进入Settings（设置）页面；
2. 找到VAE选项（在 "SD Upscale / General" 相关设置区）；
3. 下拉列表中选择sdxl.vae.safetensors；
4. 点击Apply settings，再Save settings保存。

也可以快捷地在生成页面（txt2img / img2img）底部的 "VAE" 下拉框中直接切换。

第 3 步：移除 --no-half-vae 参数

如果你之前为了规避黑图问题，在启动脚本中加了--no-half-vae：

• Linux / macOS：编辑webui-user.sh，删除含--no-half-vae的行；
• Windows：编辑webui-user.bat，找到set COMMANDLINE_ARGS=后面的--no-half-vae并删除。

删除后重启 WebUI，VAE 将重新以 fp16 半精度运行，显存占用更低、解码更快。✅

五、进阶：Diffusers（Python）中的用法

如果你使用 Python + Diffusers 开发，只需一行加载即可：

from diffusers import AutoencoderKL vae = AutoencoderKL.from_pretrained("madebyollin/sdxl-vae-fp16-fix", torch_dtype=torch.float16)

将vae传给 SDXL base 与 refiner 两个 pipeline 即可。

六、常见问题 FAQ 💬

Q1：修复版 VAE 会影响出图质量吗？A：修复版与原版 SDXL VAE 的输出存在极细微差异，但对绝大多数场景肉眼不可辨，可以忽略。

Q2：兼容 SDXL 1.0 吗？A：兼容。该修复基于 SDXL VAE (0.9) 微调，同样适用于 SDXL 1.0。

Q3：其他 VAE 能用这个文件吗？A：不能。它是专为 SDXL 的 VAE 修复的，SD1.5 用户无需使用。

Q4：移除 --no-half-vae 后又能出黑图了怎么办？A：确认你在设置里真正选中了sdxl.vae.safetensors，而不是 "Automatic / Disabled"。

七、写在最后

通过本教程的三步配置（放入文件 → 设置选中 → 移除参数），你就完成了 SDXL-VAE-FP16-Fix 的完整安装。它能让你的 SDXL 出图流程恢复 fp16 高速模式，同时告别黑图困扰。快去试试吧！🚀

【免费下载链接】sdxl-vae-fp16-fix项目地址: https://ai.gitcode.com/hf_mirrors/madebyollin/sdxl-vae-fp16-fix