项目页面样式失效通常因依赖未装全或构建工具链缺失：需删 node_modules 和 package-lock.json 后用 npm install --no-audit --no-fund 重装，并验证 css-loader/style-loader 是否存在；再检查 webpack/Vite 的 CSS 处理配置是否启用、CSS 文件路径是否正确、Vue scoped 样式是否影响全局匹配。
项目跑起来后页面样式全无，浏览器控制台没报错，但CSS文件明明在node_modules里却没生效——这通常不是代码写错了，而是npm install看似成功，实则部分依赖根本没装全、装对，或者关键构建工具链缺失。
确认 node_modules 是否真被完整安装
第一步：删掉现有 node_modules 和 package-lock.json。不要只删 node_modules，【package-lock.json 必须同步删除】，否则 npm 会按旧锁文件复原不兼容的依赖树。
第二步：运行 npm install --no-audit --no-fund。加这两个参数能跳过安全扫描和赞助提示，避免因网络波动卡在 audit 阶段导致看似完成实则中断。
第三步：安装结束后，立刻执行 npm ls css-loader style-loader。如果返回「empty」或「missing」，说明核心 CSS 处理器根本没装上——这不是网络问题，是 package.json 里漏写了 devDependency 或版本范围写死了不匹配当前 Node 版本。
立即学习“前端免费学习笔记（深入）”；
检查 webpack 或 Vite 的 CSS 处理插件是否启用
方法一（Webpack 项目）：打开 webpack.config.js，确认 module.rules 中存在匹配 /\.css$/ 的 rule，且 use 数组里至少包含 'style-loader' → 'css-loader' → 'postcss-loader'（若用 PostCSS）。缺任意一个，CSS 就不会被解析注入 DOM。
方法二（Vite 项目）：直接查看 vite.config.ts 或 .js。Vite 默认支持 CSS，但如果你禁用了 css: { modules: true } 却没给 .module.css 文件命名，普通 .css 文件会被忽略。此时只需删掉 config 里显式关闭 css 的配置项即可。
注意：Vue CLI 项目若升级到 Vue CLI 5+，@vue/cli-service 内置了 css 相关 loader，但如果你手动覆盖了 chainWebpack 配置，【务必保留 cssRule.use('vue-style-loader') 或等效的 style-loader 调用】，否则热更新时样式会丢失。
验证 CSS 文件是否被正确 import 或 require
打开入口 JS/TS 文件（如 main.js 或 index.ts），查找 import './assets/index.css' 这类语句。如果路径写成 import '../assets/index.css' 且实际目录结构是 src/assets，Webpack 就找不到文件，也不会报错，只会静默跳过。
如果使用的是动态 import()，比如 const loadCSS = () => import('./theme.css')，请确认该调用被执行了——它不会自动运行，必须显式调用 loadCSS() 才会加载。
Vue 单文件组件中，
