
Styles not loading
快速结论:该报错通常出现在用户通过电子表格软件(如 Excel、Google Sheets)编辑 styles.csv 文件后,文件格式或编码被破坏导致 Forge 无法解析。优先排查思路:使用纯文本编辑器(如 VS Code)重新创建 styles.csv,确保每行严格遵循“name,prompt,negative_prompt”格式,且包含逗号的字段用双引号包裹。
问题场景
在 Stable Diffusion WebUI Forge 中,用户保存或编辑自定义样式(Style)后,样式列表无法加载,终端显示解析错误。问题出现在 styles.csv 文件的读取环节,用户通常使用电子表格软件修改该文件。
报错原文
Error loading styles.csv: ... (终端中显示的 CSV 解析错误,具体错误信息因文件损坏情况而异)
注:Issue 中未提供完整报错粘贴,仅有终端截图。
原因分析
可能原因:
- CSV 格式不正确:用户手动编辑 styles.csv 后,文件头或字段分隔符不符合 Forge 要求。第一行必须是
name,prompt,negative_prompt,后续每行须严格保持三列,包含逗号的字段必须用双引号包裹。 - 编码污染:使用电子表格软件(如 Excel、Google Sheets)打开并保存 CSV 后,文件中会混入不可见的 BOM 或编码标记,导致 Forge 无法识别。Issue 用户确认在 VS Code 中能观察到这类乱码,且手动用纯文本编辑器重建文件可解决。
- 非强制推测:Issue 用户提到简单交换 CSV 中某行的顺序也会导致样式全部消失,说明 Forge 对 CSV 格式非常敏感,任何不规范的换行或空白字符都可能触发解析失败。
环境排查
- 确认使用的 Forge 版本(Issue 对应 lllyasviel/stable-diffusion-webui-forge 仓库)
- 检查 styles.csv 文件的实际编辑工具(电子表格软件 / 纯文本编辑器)
- 对比 Forge 自带的参考文件
styles_integrated.csv(位于仓库根目录)的格式 - 用 VS Code 等工具查看 styles.csv 的原始编码,确认无多余 BOM 或不可见字符
解决步骤
-
删除当前 styles.csv(建议备份)
将 Forge 配置文件目录下的 styles.csv 移至备份文件夹,或直接重命名为styles_backup.csv。 -
手动创建正确格式的 styles.csv
使用纯文本编辑器(如 VS Code、Notepad++),避免使用任何电子表格软件。新建文件,第一行必须为:name,prompt,negative_prompt每行一个样式,格式示范(包含逗号时用双引号):
MyStyle1,My prompt without comma,My negative prompt MyStyle2,"My prompt, with comma","My negative, also with comma" MyStyle3,Prompt only no negative,保存文件为
styles.csv,编码选择 UTF-8(不带 BOM)。 -
替换并重启 Forge
将新创建的 styles.csv 放入 Forge 的配置目录,重启 WebUI。可优先尝试此方法。 -
如果使用电子表格软件,请遵循导出规则
如果坚持使用电子表格,必须在创建格式为三列(A: name, B: prompt, C: negative_prompt)后,导出为 CSV(逗号分隔)。导出后用纯文本编辑器检查文件中是否插入多余编码。Issue 用户反馈该操作仍会引入乱码,因此推荐上一步直接手动编辑。
验证方法
重新启动 Forge 后,在 UI 中点击“Styles”下拉菜单,确认之前添加的样式名称列表正常显示,并可以应用。同时终端不应再输出 CSV 解析相关的错误信息。



