React中引入CSS框架应优先按需导入避免全局污染，推荐CDN或import指定路径；CSS-in-JS用于动态样式与组件隔离，需明确分工、避免混用；主题切换需同步CSS变量与JS逻辑，注意SSR和构建体积优化。
React中直接引入CSS框架（如Bootstrap、Tailwind）的正确姿势
直接在index.html里用<link>引入CDN，或在src/index.js顶部import 'bootstrap/dist/css/bootstrap.min.css'，是最轻量、最无侵入的方式。但要注意：全局CSS会污染组件样式作用域，比如.btn可能意外覆盖你自定义的按钮类。
实际项目中更推荐按需引入——用@import或require只加载用到的模块。例如Tailwind配合postcss-import，可写@import 'tailwindcss/components';；Bootstrap则建议用bootstrap/scss/_buttons.scss这类路径单独导入，避免打包进未使用的栅格、表单等样式。
- 确保CSS框架的JS插件（如Bootstrap的
Modal）与React生命周期兼容，优先用React封装版（如react-bootstrap） - 若使用CSS Modules，别对框架类名启用
modules: true，否则className={styles['btn-primary']}会失效——框架类必须走全局作用域 - Webpack中检查
css-loader配置是否启用了modules: { auto: /\.module\.css$/ }，避免误将bootstrap.css当作模块处理
用CSS-in-JS（如Emotion、Styled Components）接管关键组件样式
CSS-in-JS不是用来重写整个UI库，而是解决「动态样式」和「组件级隔离」这两个CSS框架搞不定的问题。比如一个根据status prop切换背景色的卡片：background: { pending: '#ffcc00', success: '#00cc66' }[props.status]——纯CSS框架得写一堆预设类，而Emotion一行就能内联计算。
注意不要混合使用：别在一个组件里既用className="btn btn-primary"又用css={...}去覆盖同个属性，这会导致优先级混乱和调试困难。建议明确分工——框架负责基础原子类（flex、text-sm、border），CSS-in-JS负责业务逻辑强相关的样式（状态响应、主题切换、动画控制）。
立即学习“前端免费学习笔记（深入）”；
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- Emotion的
cssprop需要Babel插件@emotion/babel-plugin支持，否则会报css is not defined - Styled Components的
as属性能透传HTML标签，但若透传为as="button"，记得手动加type="button"防止表单意外提交 - 服务端渲染时，Emotion需用
CacheProvider包裹根组件，并确保extractCritical拿到全部样式，否则首屏缺失CSS
混合方案下的class名冲突与调试技巧
当className="card p-4"（Tailwind）和css={css`box-shadow: 0 2px 8px rgba(0,0,0,0.1)`}（Emotion）共存于同一DOM节点，浏览器开发者工具里看到的最终box-shadow值，取决于CSS源码顺序和选择器权重——Emotion生成的class通常带data-emotion属性，权重高于普通类，但低于!important或内联style。
调试时别只盯着Computed Styles面板，要切到Styles侧边栏，逐行关掉CSS规则看变化。特别留意那些由JS动态注入的style标签，它们常被Emotion/Styled Components插入到<head>末尾，容易被忽略。
- 用
data-testid代替class做E2E测试定位，避免样式重构导致测试失败 - Chrome DevTools的Rendering面板开启
Paint Flashing，能快速识别因CSS-in-JS频繁重计算导致的无效重绘 - 如果发现某组件样式始终不生效，检查是否被CSS框架的
all: unset或revert重置规则影响——Tailwind v3默认启用@layer base里的*, ::before, ::after { box-sizing: border-box; }，但某些重置库会覆盖它
主题切换与CSS变量如何与CSS-in-JS协同
CSS变量（--primary-color）适合管理全局主题色、间距、圆角等静态设计令牌，而CSS-in-JS适合消费这些变量并做运行时转换。例如Emotion支持css`color: var(--primary-color);`，但若要根据主题深浅自动调整文字对比度，就得用JS逻辑：color: isDark ? 'white' : 'black'。
关键点在于变量注入时机：必须在根组件挂载前，通过document.documentElement.style.setProperty('--primary-color', '#007bff')设置，否则CSS-in-JS初次渲染时读到的是空值。React 18的并发渲染下，还建议用useLayoutEffect而非useEffect来同步更新CSS变量，避免闪屏。
- Tailwind可通过
theme.extend把CSS变量接入colors.primary.DEFAULT，但需搭配darkMode: 'class'和html.dark手动切换，不能依赖prefers-color-scheme自动响应 - Emotion的
Global组件适合注入全局CSS变量声明，但别在里面写媒体查询——应放在独立CSS文件中由构建工具处理 - 服务端渲染时，CSS变量无法直接从Node环境注入到客户端
document，需用getServerSideProps把主题配置序列化进window.__INITIAL_THEME__，再由客户端脚本读取并设置
实际项目里最易被忽略的，是CSS框架和CSS-in-JS在构建产物体积上的叠加效应——Tailwind的完整CSS文件约200KB，Emotion运行时约12KB，两者同时引入且未做tree-shaking，很容易让样式代码膨胀3倍以上。真正该砍的不是技术选型，而是没被引用的@layer components规则、未使用的styled.div模板字面量、以及所有被/<em> purgecss ignore </em>/标记却早已下线的功能模块。
