console.assert基础用法与错误提示

`console.assert` 是一个轻量级的开发调试工具，仅在断言条件为 `false` 时向控制台输出格式化信息，但不会中断执行、不抛出错误、不被 `try/catch` 捕获，也**无法替代真正的错误处理或类型守卫**；它易被构建工具（如 Webpack/Terser）在生产环境静默移除，依赖 DevTools 控制台设置与日志级别，且在 TypeScript 中不触发类型收窄——看似“报错”，实则只是提醒你：代码仍在带病运行，而你可能还没意识到问题已悄然蔓延。

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"] }]

真正容易被忽略的是：它不改变程序控制流，也不提供恢复能力。你看到红字报错，不代表代码停了——它可能已经带着错误数据继续跑完一整条链路。

到这里，我们也就讲完了《console.assert基础用法与错误提示》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！