要真正管住生产环境里的 console,需分阶段控制:开发时允许、构建时识别、上线前剥离;ESLint 是第一道防线,能精准识别所有 console 调用变体,配合 Babel 插件在编译期物理移除,并覆盖自定义封装场景,禁用全局覆盖等高风险操作。

要真正管住生产环境里的 console,不能只靠“关掉报错”或简单删代码。核心是分阶段控制:开发时能用、构建时识别、上线前剥离——ESLint 是其中最可靠的第一道防线。
用 ESLint 在编码阶段精准拦截
ESLint 基于 AST 分析,能识别所有真实调用,包括别名、解构、动态访问等变体(比如 const { log } = console 或 c = console; c.info()),不会像正则那样漏掉。
- 安装插件:
npm install eslint-plugin-no-console --save-dev - 在
.eslintrc.js中配置,只允许生产必需的级别:'no-console': ['error', { allow: ['warn', 'error'] }] - 配合 CI 流程运行:
npx eslint src/ --env browser,node,不通过就阻断合并
配合 Babel 在构建期彻底移除
ESLint 只报错不删码,真正“物理清除”得靠编译阶段。Babel 插件能安全删除 AST 节点,避免误伤字符串或注释里的 console 字样。
- 推荐使用官方维护的
@babel/plugin-transform-console - 在
babel.config.js中按环境启用:production: { plugins: ['@babel/plugin-transform-console'] } - 默认保留
warn和error,删掉logdebuginfo,符合监控需要
对自定义封装场景做额外覆盖
如果团队统一用 logger.info() 包裹 console,ESLint 默认规则无法追踪到内部调用,需补充防护:
- 用
no-restricted-syntax规则禁止特定调用模式,例如:{ selector: "CallExpression[callee.object.name='logger'][callee.property.name='info']", message: "生产环境禁用 logger.info" } - 或开发轻量自定义规则,匹配 AST 中所有指向
console的间接调用链 - 在 CI 中加一道检查脚本,扫描构建产物里是否残留
console\.log等字面量(仅作兜底)
避免常见误操作
全局覆盖 console.log = () =>{} 看似简单,实则风险高:
- 必须在所有 JS 执行前注入,否则模块内已绑定的引用不受影响
- 若同时屏蔽
error和warn,线上异常将无声消失,失去基础监控能力 - 无法区分开发/生产环境,本地调试也失效,降低开发效率











