Next.js App Router中CSS加载顺序错乱的根本原因是渲染阶段与注入时机不一致，必须在app/layout.tsx顶层静态导入全局CSS（如globals.css、bootstrap.min.css），且禁用'use client'，确保SSR内联到；Bootstrap JS需在'use client'组件中动态import()延迟初始化。
CSS加载顺序错乱会导致样式覆盖、闪动、媒体查询失效，尤其在混合使用全局CSS、CSS-in-JS和框架样式（如Bootstrap）时。 根本原因不是“谁先写”，而是Next.js App Router中不同导入位置对应不同的渲染阶段（服务端 vs 客户端）和注入时机（内联 vs 外链）。必须按执行上下文分层控制，不能靠文件顺序“碰运气”。
app/layout.tsx 顶层静态导入是唯一安全的全局CSS入口
所有全局CSS（如 globals.css、bootstrap.min.css）必须且只能出现在 app/layout.tsx 的最顶部，且不能加 'use client'：
- 它会在服务端渲染（SSR）阶段提取并内联到
中，保证首屏样式可用 - 如果放在
page.tsx或组件内部，会触发Global CSS cannot be imported from files other than your Custom _app.js错误（即使你没用 Pages Router） - 路径必须相对正确：
import './globals.css'（推荐放app/globals.css），而不是import '../styles/global.css'（容易因目录层级错位导致404） - 多个CSS文件按导入顺序决定层叠优先级：后导入的规则可覆盖先导入的同名选择器
Bootstrap等含JS依赖的CSS必须隔离客户端初始化
bootstrap/dist/css/bootstrap.min.css 可以安全导入，但它的 JS 插件（dropdown、modal）不能直接 import —— 否则构建报 ReferenceError: window is not defined：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 只在
app/layout.tsx顶层导入 CSS：import 'bootstrap/dist/css/bootstrap.min.css' - JS 初始化必须包裹在
'use client'组件中，并用useEffect+ 动态import()延迟到浏览器环境：
'use client'
import { useEffect } from 'react'
export default function BootstrapClient() {
useEffect(() => {
import('bootstrap/dist/js/bootstrap.bundle.min.js')
}, [])
return null
}
layout.tsx 中作为子组件渲染（如放在 Stitches/vanilla-extract 等零运行时方案不参与CSS顺序竞争
它们生成的是静态CSS文件，在构建期就写入 .next/static/css/，运行时只注入 class 名。因此：
立即学习“前端免费学习笔记（深入）”；
- 它们的样式优先级由生成的 class specificity 决定，与导入顺序无关
- 但主题变量、断点定义（如
stitches.config.ts中的media）会影响最终生成的 CSS 规则顺序，需手动检查输出文件确认断点是否被覆盖 - 若与全局CSS冲突（比如都定义了
button），全局CSS因在最前注入而具有更高层叠权重，此时应改用更具体的 class（如styled('button', { ... })）而非依赖顺序
最容易被忽略的是：动态路由段（如 app/projects/[id]/layout.tsx）里的 CSS 导入，只作用于该子树，不会影响根布局或兄弟路由 —— 这种“局部作用域”看似方便，但会让样式来源分散，调试时得逐层检查每个 layout.tsx 的导入顺序。
