TailwindCSS源文件路径关联报错：未检测到工具类

问题描述 #

运行TailwindCSS时出现如下警告：

warn - No utility classes were detected in your source files. If this is unexpected, double-check the `content` option in your Tailwind CSS configuration.

已查阅该错误的相关详细解释，检查所有配置路径后仍未定位问题，推测是路径配置有误。目前tailwind.config.js已配置关联根目录下的./index.html文件，代码托管在GitHub仓库。

可能的排查方向 #

• 确认tailwind.config.js中的content路径是否存在大小写不匹配（部分系统区分文件名大小写）
• 检查index.html中是否确实使用了Tailwind工具类，而非自定义类或未被识别的写法
• 验证构建工具（如Vite、Webpack）是否正确读取了tailwind.config.js配置，是否有额外路径规则影响检测
• 尝试扩展content路径范围，比如设置为./**/*.html覆盖所有HTML文件，测试能否检测到工具类

内容的提问来源于stack exchange，提问作者buleva