container-type必须显式声明在父元素CSS中，否则@container规则静默失效；常见错误包括未声明、设在HTML中、用在flex/grid直接子项或display:contents元素上，且不继承。
container-type 必须显式声明，否则整个 @container 规则静默失效
浏览器默认不把任何元素当作可查询容器——这不是兼容性问题，而是规范强制要求。只写 @container (min-width: 400px) 而没给父元素加 container-type: inline-size，DevTools 里完全看不到对应样式生效，也不会报错，只会跳过整条规则。
常见踩坑点：
- 在 React/Vue 组件根元素上直接写
@container，但忘了给该元素加container-type - 误以为
display: flex或width: 100%就自动具备容器资格，其实必须手动声明 - 把
container-type加在祖父节点，指望它“传给”孙子，但容器查询不继承，只能作用于直接祖先
Flex/Grid 容器子项需额外处理尺寸稳定性
在 display: flex 或 display: grid 的直接子元素上设 container-type: inline-size，常出现宽度为 0px 或测量失真。这是因为 flex item 默认有最小宽度限制（min-width: auto），会撑满可用空间，导致无法反映真实内容宽度。
安全做法：
立即学习“前端免费学习笔记（深入）”；
- 给子项加
min-width: 0或width: fit-content，释放其自主收缩能力 - 避免直接给 flex/grid 容器本身设
container-type——它的尺寸由算法分配，不稳定；改用其子项作为查询容器 - 确认父级没有
overflow: hidden、flex: 1且无同级兄弟时占满全部空间，这类布局会让子项失去独立尺寸上下文
Tailwind 用户务必检查四重启用条件
Tailwind 的容器查询插件不是开箱即用功能，漏掉任一环节都会导致 @container 类完全不生成 CSS。
必须同时满足：
- Tailwind v3.4+ 版本
-
tailwind.config.js根对象中开启experimental.containerQueries: true - 安装并注册插件：
npm install -D @tailwindcss/container-queries+plugins: [require('@tailwindcss/container-queries')] - 所有
@container规则必须包裹在@layer utilities或@layer components内
特别注意：@container 工具类（如 @container/main）需要 HTML 元素显式携带该 class，不能只靠 CSS 定义。
生产环境调试要盯紧 DevTools 的 Container query containers 面板
Chrome 和 Edge 的 Elements 面板底部有 “Container query containers” 区域，点击后能直观看到哪些节点被识别为容器、类型是什么、是否带 name。这是唯一可靠确认容器是否“上线”的方式。
容易忽略的关键点：
- 即使写了
container-type: inline-size，如果该元素当前 computed styles 中container属性为空或显示none，说明它未构成有效容器上下文 - 命名容器（如
container-name: card）拼错名字时，@container card规则会被静默丢弃，DevTools 里根本不会列出这条规则 - 使用 Shadow DOM 时，
container-type必须加在 shadow host 上，且只对内部元素生效
