CSS文件未生效主因是未在入口JS中显式import，且Tailwind等需PostCSS配置；构建工具不自动处理node_modules中CSS，须检查import路径、loader配置及postcss插件注册。
npm install 后 CSS 文件没生效，是不是漏了 import？
安装完像 normalize.css 或 tailwindcss 这类纯 CSS 库，node_modules 里确实有文件，但页面没变化——大概率是构建工具根本没读它。Webpack、Vite、Rollup 默认不会自动处理 node_modules 里的 CSS，必须显式引入。
常见做法是在入口 JS 文件（如 main.js 或 index.js）里加一行：
import 'normalize.css';
注意：不是 import 'normalize.css/normalize.css'，多数现代 CSS 包已配置好 main 或 style 字段，直接导入包名即可。如果报错“cannot resolve”，检查该包的 package.json 里 style 字段指向是否正确。
- 用 Vite 时，
importCSS 是默认支持的；Webpack 则需确保配置了style-loader+css-loader - 如果项目用的是 CSS-in-JS 或 Shadow DOM，外部 CSS 可能被作用域隔离，此时 import 无效
- 某些包（如
bootstrap）分 CSS 和 JS 两部分，只 import CSS 不会自动加载 JS 行为
tailwindcss 的 postcss 配置为什么必须手写？
tailwindcss 不是「装完就能用」的 CSS 库，它本质是 PostCSS 插件，需要构建流程参与编译。npm install 只是把代码拉下来，真正起作用的是 postcss.config.js 里声明的 tailwindcss() 插件。
立即学习“前端免费学习笔记（深入）”；
典型配置：
module.exports = {
plugins: {
'tailwindcss': {},
'autoprefixer': {},
}
}
漏掉这步，哪怕你在 @tailwind 指令写的 CSS 文件里写了 @tailwind base;，最终生成的 CSS 里也不会展开任何实用类。
-
tailwind.config.js是可选的，但postcss.config.js+tailwindcss插件注册是硬性依赖 - Vite 用户容易误以为
vite-plugin-tailwind能替代配置，其实它只是帮你自动注入插件，底层仍走 PostCSS 流程 - 如果构建后 CSS 体积异常小（比如只有几行），大概率是 Tailwind 没被 PostCSS 执行到
如何让 node_modules 里的 CSS 支持 @import 和 url()？
直接 import 'some-lib/dist/style.css' 时，若该 CSS 内部用了 @import './theme.css' 或 url('./icon.svg')，可能报路径错误——因为 Webpack/Vite 默认不解析 CSS 内部的相对路径，尤其跨包时。
解决方法取决于构建工具：
- Webpack：在
css-loader配置中打开url: true和import: true（v6+ 默认开启，老版本需手动设） - Vite：默认支持，但若引用的是未打包的源码 CSS（含
src/下的@import），需确认该包发布了正确的exports字段或使用resolve.alias - 通用保险做法：改用
import替代 CSS 内的@import，例如把node_modules/foo/style.css里的@import './reset.css';拆成两行import 'foo/reset.css'; import 'foo/style.css';
另外，url() 引用的字体、图片等资源，如果路径是相对 node_modules 内部的，构建工具通常能自动定位；但如果是相对你项目目录的路径（比如 url('../assets/logo.png')），就会 404。
升级 CSS 库版本后样式突变，怎么快速定位原因？
CSS 库不像 JS 库有明确的 breaking change 提示，视觉回归往往靠肉眼。最有效的排查路径是比对产物 CSS：
- 用
npx tailwindcss -o ./dist/tailwind.css --minify（Tailwind）或cat node_modules/some-lib/dist/style.css | wc -l粗略看体积是否剧增/骤减 - 搜索关键选择器是否存在：比如升级
ant-design后按钮变宽，grep.ant-btn在构建产物中是否还存在，或者是否被新类名（如.ant-btn-v5）替代 - 检查包的
package.json中style字段是否变了——有些库 v5 改用dist/index.css，v4 是dist/antd.css，import 路径没同步更新就等于没引入 - 留意是否新增了 CSS scope 或 :where()、:has() 等新语法，老浏览器可能不兼容导致样式失效
真正麻烦的不是升级本身，而是多个 CSS 库之间规则优先级被新版本悄悄改动——比如一个库从 .btn { color: red; } 改成 .btn:not([disabled]) { color: red; }，逻辑没变，但叠加其他库的 [disabled] { opacity: 0.5; } 就可能出意料之外的渲染。
