Tailwind的content字段不能写相对路径，因其解析始终以process.cwd()为基准，执行位置变动会导致路径错位；必须用path.resolve(__dirname, '..')生成绝对路径，确保各子包独立配置并显式覆盖所有文件后缀。
content路径为什么不能写相对路径（如../packages）
Tailwind CLI 解析 content 字段时，始终以 process.cwd()（即你执行 pnpm build 或 npm run dev 的当前目录）为基准解析路径。你在 apps/web/tailwind.config.js 里写 "../packages/ui/src/**/*.{ts,tsx}"，但若在根目录运行 pnpm build，.. 就会指向错误位置，导致扫描完全失效。
更麻烦的是：Tailwind 不报错、不警告，只会静默跳过这些路径——最终生成的 CSS 文件体积极小，类名全丢，你却找不到原因。
- 绝对路径是唯一可靠解法：用
path.resolve(__dirname, '..')基于配置文件自身位置定位 - 不要依赖 IDE 自动补全或复制粘贴的“看起来对”的路径
- Windows 下反斜杠
\完全兼容，无需转义或替换
如何用 path.resolve 写出稳定 content 路径
在 tailwind.config.js 开头引入 path，所有 content 条目都用 path.resolve 构造：
const path = require('path');
module.exports = {
content: [
path.resolve(__dirname, '../packages/ui/src/**/*.{js,jsx,ts,tsx}'),
path.resolve(__dirname, '../../apps/admin/src/**/*.{js,jsx,ts,tsx}'),
path.resolve(__dirname, '../packages/shared/src/**/*.{js,jsx,ts,tsx}'),
],
// ...
};
-
__dirname指向当前tailwind.config.js所在目录，不受执行位置影响 - 每个子包应维护自己的
tailwind.config.js，而不是共用根目录一份（避免多版本 Tailwind 行为不一致） - 如果某个包用的是
lib目录而非src，路径必须同步改成lib/**/*.{js,jsx,ts,tsx}
为什么通配符 ./packages/**/src/** 会失效
Tailwind 内置的 glob 解析器（基于 fast-glob）不支持嵌套通配符匹配。写 "./packages/**/src/**/*.{ts,tsx}" 在 v3/v4 中均不可靠——它可能只匹配到第一层子目录，漏掉 packages/button/src 或 packages/card/src。
立即学习“前端免费学习笔记（深入）”；
- 必须显式列出每个需扫描的包路径，哪怕有 10 个也要逐条写
- 后缀要全覆盖：
.svelte（SvelteKit）、.astro（Astro）、.mdx（文档站）都不能漏 - 不要加
node_modules下的路径到content，除非你明确引用了第三方 UI 库的源码（如shadcn-svelte）
改完 content 后样式仍不生效？检查这三件事
不是改了配置就立刻生效。Tailwind 会缓存已扫描的文件列表，尤其在开发服务器中。
- 必须彻底重启 dev server（比如
pnpm dev进程），热更新不触发重扫描 - 清除 Turborepo 缓存：
turbo prune，否则旧构建产物可能被复用 - 加一个临时类验证，比如在组件里写
class="bg-[#00ff00] text-2xl"，然后看浏览器元素面板是否生成对应 CSS 规则；没出现就是还没扫到
最常被忽略的点：路径写对了，但没重启进程；或者路径里漏了 .svelte 后缀，而项目恰好是 SvelteKit —— 它不会提醒你，只会把所有组件里的类名 purge 干净。
