console.assert仅在第一个参数为false时输出信息，需确保开发者工具控制台开启且未过滤assert日志，生产环境可能被构建工具移除；支持多参数格式化但不中断执行，非错误处理机制。
console.assert 为什么有时不报错也不输出
它只在第一个参数为 false 时触发输出，且必须开启浏览器开发者工具的「控制台」面板（部分环境如 Node.js 默认不显示 assertion failed 提示）。如果控制台被过滤掉 assert 级别日志，或当前运行环境禁用了 assertion（例如某些构建工具压缩后移除了 console.assert 调用），就会“静默失败”。
- 确保 DevTools 控制台左上角的日志级别包含
assert（Chrome/Firefox 默认开启） - Node.js 中需加
--enable-source-maps并使用util.inspect风格格式化，否则仅打印false - Webpack/Vite 构建时，
mode: 'production'下 Terser 可能直接删掉所有console.*，需配置drop_console: false保留assert
怎么让 console.assert 显示更清晰的上下文信息
第二个及之后的参数会被格式化为字符串拼接在错误消息后，类似 console.log，支持占位符和对象展开。但注意：它不会自动打印堆栈，也不像 throw new Error() 那样中断执行。
- 用
console.assert(x > 0, 'x 应为正数，但得到', x)比单纯写console.assert(x > 0)更易定位问题 - 传入对象会触发展开（Chrome/Firefox），例如
console.assert(data?.id, 'data 缺失，完整值:', data) - 避免在断言中调用副作用函数，如
console.assert(apiCall(), 'API 必须成功')—— 即使断言不触发，apiCall()仍会执行
console.assert 和 if + throw Error 的关键区别
console.assert 是调试辅助手段，不是错误处理机制。它不抛出异常，不进入 catch，也不会被 try/catch 捕获；而 throw new Error() 会中断同步流程并可被上层捕获。
- 适合场景：
开发阶段校验 props 类型、API 响应结构、循环不变量 - 不适合场景：
用户输入校验、权限检查、需要 fallback 逻辑的失败路径 - 性能影响极小，但频繁用于高频函数（如 canvas 渲染帧内）可能拖慢 DevTools 渲染，建议仅保留在开发环境（可用
process.env.NODE_ENV !== 'production'包裹）
在 TypeScript 中如何避免类型检查绕过
TypeScript 不会基于 console.assert 推断类型守卫（type guard），也就是说，即使你写了 console.assert(typeof x === 'string', ...)，后续代码里 x 依然保持原联合类型。这和 if (typeof x === 'string') 不同。
- 若需类型收窄，仍得用
if或自定义类型守卫函数 - 可搭配
as const或非空断言（!）临时绕过，但属于强制类型转换，不推荐在关键路径使用 - ESLint 规则
no-console默认禁用console.assert，需在配置中显式允许："no-console": ["warn", { "allow": ["assert"] }]
