linaria 必须在构建阶段提取样式，启用 outputcss: true 才生成独立 css 文件；否则样式保留在 js 中，丧失零运行时特性。
必须在构建阶段完成样式提取，否则 css 标签写的样式会留在 JS 里执行，彻底失去“零运行时”意义。
确认 outputCss: true 已启用
Linaria 默认不生成独立 CSS 文件——它只做语法解析和类名生成，outputCss: true 才触发真正的构建期提取。Vite 用户需在 linaria() 插件配置中显式开启：
- 未设该选项 → 样式保留在 JS 中，浏览器端仍需运行时解析，等同于普通 CSS-in-JS
- 设为
false或遗漏 → 构建产物含css函数调用，体积增大且有运行时开销 - Vite 不会自动注入
<link rel="stylesheet">，需手动确保生成的 CSS 被 HTML 加载（如通过build.rollupOptions.output.manualChunks控制输出路径后，在index.html中引用）
css 标签内禁止运行时插值
Linaria 的零运行时依赖静态可分析性。css 模板字符串里的内容必须在构建时能完全确定，任何动态值都会导致编译失败或回退到运行时模式：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- ❌
css`color: ${props.color};`——props是运行时变量，无法提取 - ✅
css`color: var(--color, #000);`+ 用style属性传入--color—— CSS 变量由浏览器运行时接管，静态部分仍可提取 - ✅ 使用
@media、嵌套选择器、:hover等纯 CSS 特性 —— 全部支持，且 sourcemap 可精准定位源位置
搭配 cx 合并类名时注意副作用
cx 是运行时函数，但它只做字符串拼接，不生成样式，因此不影响零运行时目标。但要注意：
-
cx参数必须是静态类名（即css返回的字符串或已知 class 字符串），不能是拼接表达式：cx('a', condition && 'b')是允许的；cx('a' + suffix)会导致构建失败 - TypeScript 类型
LinariaClassName仅用于标注返回值，不参与构建逻辑，但能防止误传非样式类名 - 若项目用了
@linaria/react的styled，它的底层仍依赖css和cx，规则同样适用
最容易被忽略的是：即使所有代码写法都正确，只要构建工具链没把 Linaria 插件放在 Babel 处理流程的最前端，就可能因其他插件提前转义模板字符串而导致提取失败——务必检查插件顺序，linaria 必须早于 babel 或 ts 相关转换。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
