直接原因是多个依赖间接引入不同版本CSS库导致构建时样式覆盖；需用npm ls检查版本树、显式锁定高版本、统一CDN或npm引入、验证PostCSS兼容性并确保构建工具加载正确路径。
npm install 时 CSS 库版本不一致导致样式错乱
直接原因不是 CSS 本身冲突，而是多个依赖间接引入了不同版本的同一 CSS 库（比如 normalize.css、bootstrap 或 tailwindcss），构建时可能混入旧版规则，覆盖预期样式。
常见现象：button 圆角突然变直、font-size 被重置、margin 行为异常，且在 dev 模式下正常、build 后出问题——大概率是打包工具把多个 node_modules/xxx/dist/*.css 按引入顺序拼到了一起，旧版后加载就赢了。
- 用
npm ls <package-name>查当前项目里实际安装的版本树，例如npm ls normalize.css - 检查
package-lock.json中该库是否出现在多个路径下，尤其留意requires字段嵌套层级 - 若发现多个版本共存（如
4.2.0和5.0.1），优先锁定高版本：在package.json中显式写"normalize.css": "^5.0.1"，再npm install
pnpm 下 CSS 文件被硬链接复用但样式仍不一致
pnpm 的硬链接机制会让不同包共享同一份 node_modules/xxx，看似能避免重复，但若 A 包依赖 bootstrap@4、B 包依赖 bootstrap@5，pnpm 会分别创建 node_modules/bootstrap 和 node_modules/.pnpm/bootstrap@5.x/node_modules/bootstrap —— 构建工具若从不同路径 import，就真会加载两套 CSS。
- 运行
pnpm list bootstrap看是否真有多个解析路径 - 在构建配置中（如 Vite 的
resolve.alias或 Webpack 的resolve.alias）强制统一入口：{"bootstrap": "bootstrap/dist/css/bootstrap.min.css"} - 更稳妥的是删掉所有间接依赖里的 CSS 引用，只在主应用层
import 'bootstrap/dist/css/bootstrap.min.css'，禁用子包的样式自动注入
PostCSS 插件与 CSS 库版本不兼容引发编译失败
某些 CSS 库（如 tailwindcss@3.x）要求 PostCSS ≥ 8.2，而老项目里 postcss 是 7.x，npm install 后看似成功，但 tailwindcss 的 postcss-preset-env 插件会静默降级或跳过关键转换，最终生成的 CSS 缺少 @layer 支持或伪类失效。
立即学习“前端免费学习笔记（深入）”；
- 查
postcss版本：npm ls postcss，确认是否被某个子依赖锁死在低版本 - 不要只
npm install postcss@latest—— 必须同步升级postcss-loader（Webpack）或postcss（Vite），否则 loader 无法识别新版 AST - 在
postcss.config.js开头加console.log(require('postcss').version)，验证运行时加载的确实是期望版本
CDN 引入的 CSS 与本地 npm 包版本对不上
开发时用 CDN 加载 https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css，但组件库内部又通过 import 'bootstrap' 拉取本地 node_modules/bootstrap@5.2.0，两者 class 名相同但 padding/margin 微调不同，视觉上出现“部分生效、部分失效”的诡异状态。
- 禁止混用：要么全走 CDN（连 JS 也配 CDN），要么全走 npm（删掉 HTML 中的
<link>） - 若必须保留 CDN，就在 JS 中移除所有对本地 CSS 的
import，并确保组件库不自动 inject 样式（例如Element Plus要关掉auto-import） - 用浏览器开发者工具的
Computed面板点开某条样式，看source列具体来自哪个 URL 或文件路径，比猜快得多
版本锁定真正起作用的前提，是构建流程里没有其他隐式加载路径。哪怕 package.json 锁死了 ^5.0.0，只要某个 require('xxx') + '.css' 动态拼接路径，或者插件默认读取 node_modules/xxx/styles/index.css 而不是 dist/，照样绕过锁定。
