在 tailwind.config.js 中应使用 theme.extend.colors 扩展颜色，如 { brand: "#3b82f6" }，以安全添加自定义色而不覆盖默认色盘；需确保十六进制带#、键名合规、变体手动定义、修改后重启开发服务器。
在 tailwind.config.js 的 theme.extend.colors 里加十六进制值
直接往 colors 扩展对象里塞键值对就行，键是颜色名（比如 brand），值是十六进制字符串（如 "#3b82f6"）。Tailwind 会自动把它编译成对应类名，比如 text-brand、bg-brand、border-brand 都能用。
常见错误是把十六进制写成带引号的变量名，比如 "#3b82f6" 写成 "myBlue" —— 那只是个字符串，不是颜色值；或者漏掉 #，变成 "3b82f6"，Tailwind 不认这个格式，生成的 CSS 会是无效声明。
- 必须用带
#的完整十六进制，支持 3 位（"#3bf"）、4 位（"#3bf1"）、6 位（"#3b82f6"）、8 位（"#3b82f61a"） - 键名不要用连字符或数字开头，比如
"my-color"或"1primary"会导致类名生成异常 - 如果同时定义了
theme.colors和theme.extend.colors，后者只追加，不覆盖前者
为什么不能直接在 theme.colors 下覆盖默认色盘
改 theme.colors 本身会完全替换整个颜色系统，包括 gray、blue、red 这些基础色 —— 你大概率并不想丢掉它们。Tailwind 默认色盘被大量工具类（比如 hover:bg-blue-500）隐式依赖，一换全崩。
扩展才是安全做法：extend.colors 是专门设计来“只加不删”的，它和默认色盘合并后才参与构建，不影响原有类名逻辑。
立即学习“前端免费学习笔记（深入）”；
- 误写成
theme.colors = { brand: "#3b82f6" }→ 所有bg-blue-500类消失 - 正确写法是
theme.extend.colors = { brand: "#3b82f6" } - 如果真要定制默认色（比如把
blue换成公司蓝），得用theme.colors.blue = "#2563eb"，但这是覆盖，不是扩展
使用时类名不会自动带透明度变体
你加了一个 brand: "#3b82f6"，Tailwind 只生成 text-brand、bg-brand 这类基础类，但不会像默认 blue 那样自带 bg-brand-50、bg-brand-100 等明暗层级 —— 十六进制是单一值，没有内置亮度梯度。
想拥有类似体验，得手动补全整套变体，或者用插件（如 @tailwindcss/forms 不管这事，得自己动手）。
- 简单补几个常用档：
brand: { 50: "#dbeafe", 100: "#bfdbfe", 500: "#3b82f6", 700: "#1d4ed8" } - 注意键名必须是数字（不能是
"light"），否则bg-brand-light不会生效 - 所有变体仍需是合法十六进制，别混用 RGB 或 HSL
修改配置后需要重启开发服务器
Tailwind 在启动时静态读取 tailwind.config.js，运行中改了文件不会热更新新颜色类。你加完 brand，保存配置，页面上仍然找不到 bg-brand，不是写错了，是没重启。
尤其用 Vite / Next.js / Remix 这类支持 HMR 的框架时，容易误以为“改了就该立刻生效”，其实 Tailwind 的 CSS 构建是独立 pipeline，不随 JS 模块热更。
- 执行
npm run dev后改了配置 → 必须 Ctrl+C 再重跑 - 某些 IDE 插件（如 Tailwind CSS IntelliSense）可能缓存旧配置，重启编辑器也偶有帮助
- 构建生产包（
npm run build）前务必确认配置已生效，否则上线才发现text-brand样式丢失
