模型文件名禁止含中文、空格、冒号、分号、问号、星号、斜杠、竖线、引号等非法字符;仅可安全修改描述前缀、版本标识及类型前缀,且须用半角英文、数字和下划线;改名后需清日志、重启webui并验证路径与位置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

LiblibAI下载后的模型文件名不能随意修改,否则Stable Diffusion WebUI无法识别并加载该模型,生成时会报错“model not found”或直接跳过该文件;尤其当文件名中包含空格、中文、全角符号或大小写混用时,部分Windows系统或Linux服务器会因路径解析失败导致模型彻底不可用。
哪些字符绝对不能出现在模型文件名中
文件名中【禁止出现中文、空格、冒号、分号、问号、星号、斜杠(/\)、竖线(|)、引号('")】——这些字符在Windows和Linux系统中均属于非法路径符,WebUI启动时会跳过整个文件,不报错也不加载,极易误判为“模型没放对位置”。
例如:将 “水墨风_人物_v1.0.safetensors” 改成 “水墨风 人物 v1.0.safetensors”(含空格),WebUI扫描models/Stable-diffusion/目录时会忽略该文件。
全角标点如“,”“。”“:”同样触发跳过逻辑,且不易肉眼察觉,建议全部替换为半角英文符号。
可以安全修改的部分及推荐格式
仅允许修改以下三类内容,且必须全程使用半角英文、数字和下划线:
① 描述性前缀:如把 “majicMIX_realistic.safetensors” 改为 “realistic_portrait_majicMIX.safetensors” ——顺序调换不影响识别,但需保持下划线分隔、无空格。
② 版本标识:可将 “sd15_fp16.safetensors” 简化为 “sd15.safetensors”,只要不删掉核心词“sd15”即可;但不要缩成“s15”或“d15”,否则WebUI无法匹配底模类型。
③ 后缀前的简写:允许用“lora_”“vae_”“cn_”等前缀标明类型,例如 “lora_anime_face.safetensors”,这能帮助你在文件夹里快速筛选,WebUI也支持按前缀归类显示。
改名后必须执行的验证步骤
第一步:关闭Stable Diffusion WebUI → 删除webuilogsstartup.log(避免缓存干扰)→ 重启WebUI。
第二步:进入“Checkpoint”下拉菜单,观察是否出现新文件名;若未出现,打开命令行终端,进入WebUI根目录,运行:
python launch.py --skip-torch-cuda-test --no-half,查看控制台输出中是否有“Loading model from …”后跟你的新文件名路径。
第三步:如仍不显示,立即检查文件是否误放在子文件夹内(如models/Stable-diffusion/2024/),【模型文件必须直接置于models/Stable-diffusion/目录下,不可嵌套任何层级】。











