---
id: "mnruc2f0-5s52la"
name: "【避免指南】避免同时传入互斥的背景参数（gradient/color 和 image）"
type: "feedback"
project: "null"
tags: [error, avoid, poster, add_poster_background]
created: "2026-04-09"
---
【下次这样做】调用 add_poster_background 时，渐变背景(gradient)、纯色背景(color)、图片背景(image)三个参数是互斥的，不能同时传入。

错误原因：同时传入了 gradient 和 image 参数，且 image 的值是颜色码 "#F5F2EB"，系统误认为这是图片路径，导致报错 "图片文件不存在: D:\Code\foliko\#F5F2EB"。

正确做法：
- 使用渐变背景：只传 gradient 参数，不传 image 和 color
- 使用纯色背景：只传 color 参数（如 "#F5F2EB"），不传 gradient 和 image
- 使用图片背景：只传 image 参数（如 "./bg.png"），不传 gradient 和 color