weapp-tailwindcss-troubleshoot
Installation
SKILL.md
weapp-tailwindcss troubleshoot
从生成、转译、产物到运行时逐层定位根因,避免用配置猜测掩盖症状。
诊断顺序
- 收集最小复现:框架、bundler、目标端、版本、命令、原始 class、期望与实际产物。
- 读取 references/symptom-matrix.md,先归类症状,再执行对应最短路径。
- 检查 Tailwind 入口是否为纯 CSS、是否实际进入构建图、
cssEntries是否为绝对路径、@source是否覆盖源码。 - 检查是否存在第二个 Tailwind 生成器,或 H5/Web 被错误
disabled。 - 分别验证 CSS 候选、模板/JS safe class、最终平台样式文件和真实页面;不要只看固定的
app.wxss文件名。 - watch/HMR 问题要在同一进程连续新增 class,区分首次构建成功与增量图失效。
- CLI 问题先确认
web/weapptarget、stdin/stdout、source map 与 watch 模式,不期待它改写模板或脚本。 - 只有根因确认后才修改配置,并补一条可重复的回归验证。