(node:12240) [DEP0060] util._extend 已弃用如何替换？

Question

在升级 Node.js 至 12+ 版本时，项目中使用 `util._extend()` 合并对象导致触发警告：`(node:12240) [DEP0060] DeprecationWarning: util._extend is deprecated. Use Object.assign() instead.` 该方法已被标记为弃用。常见于旧版库或手动继承错误对象的场景。如何安全替换 `util._extend(target, source)` 以消除警告并保持兼容性？

Answer 1

1. 背景与问题引入

在升级 Node.js 至 12+ 版本后，许多长期维护的项目开始出现如下警告：

(node:12240) [DEP0060] DeprecationWarning: util._extend is deprecated. Use Object.assign() instead.

该警告源于 util._extend() 方法被正式标记为弃用（DEP0060）。尽管此方法在早期 Node.js 版本中广泛用于对象浅拷贝和继承，但从 Node.js 8 开始已不推荐使用，至 Node.js 12 后频繁触发运行时警告，影响日志清晰度和系统可维护性。

典型场景包括：自定义错误类继承、配置对象合并、插件系统扩展等。尤其在依赖较老版本第三方库（如某些 Express 中间件或旧版 Bluebird）时，该问题尤为突出。

2. 技术演进路径分析

• Node.js v0.x ~ v6：util._extend() 是官方推荐的对象扩展方式。
• Node.js v8：文档中明确标注为“Deprecated”，建议使用 Object.assign() 替代。
• Node.js v10+：运行时发出 [DEP0060] 警告，但功能仍保留。
• Node.js v12+：警告频率提升，提示开发者主动迁移。
• 未来版本（v16+）：虽暂未移除，但不排除彻底删除的可能性。

这一演进体现了 JavaScript 标准化趋势——语言原生能力逐步取代运行时私有工具函数。

3. 常见误用场景与代码示例

场景	原始代码	风险点
继承 Error 对象	function MyError(msg) { util._extend(this, new Error(msg)); }	无法正确捕获堆栈、instanceof 失效
配置合并	const config = util._extend(defaults, userOpts);	深层嵌套属性覆盖不完整
中间件选项初始化	options = util._extend({ timeout: 5000 }, opts);	性能较低，语义模糊

4. 安全替代方案详解

最直接且标准的替代方式是使用 Object.assign()，其行为与 util._extend() 高度一致，均为浅拷贝。

// 原写法
const merged = util._extend({}, defaults, options);

// 推荐替换为
const merged = Object.assign({}, defaults, options);

对于多层级合并需求，应结合递归逻辑或使用 Lodash 的 _.merge()：

const _ = require('lodash');
const deepMerged = _.merge({}, defaults, options);

5. 兼容性处理策略

在大型项目中，可能面临以下挑战：

1. 多个子模块独立引用 util._extend
2. 第三方库尚未更新导致间接调用
3. 需保持向后兼容旧 Node.js 环境

为此可设计兼容层：

const util = require('util');
const extend = typeof util._extend === 'function' ? util._extend : Object.assign;

// 使用统一入口
module.exports = { extend };

6. 自动化检测与迁移流程

graph TD A[扫描项目源码] --> B{是否存在 util._extend 调用?} B -- 是 --> C[定位文件与行号] C --> D[评估上下文：是否需深拷贝？] D --> E[替换为 Object.assign 或 _.merge] E --> F[单元测试验证行为一致性] F --> G[提交并标记技术债关闭] B -- 否 --> H[完成]

7. 第三方库依赖治理

若警告来自 node_modules，则说明所用库未及时升级。应对策略包括：

• 检查是否有更新版本已修复该问题
• 提交 PR 至开源仓库推动维护者更新
• 使用 patch-package 手动打补丁
• 通过 process.noDeprecation = true 临时抑制（仅限过渡期）

例如，针对 express-legacy-plugin 的 patch 文件内容：

// patches/express-legacy-plugin+1.2.0.patch
--- a/lib/index.js
+++ b/lib/index.js
@@ -10,7 +10,7 @@
-  const opts = util._extend({ port: 3000 }, config);
+  const opts = Object.assign({ port: 3000 }, config);

8. 性能与行为对比

特性	util._extend	Object.assign	Lodash.merge
标准支持	否（私有API）	ES6 标准	第三方库
浅拷贝	✓	✓	✗（默认深）
深拷贝	✗	✗	✓
性能	中等	高	较低
浏览器兼容性	无	IE11+	全面
Tree-shaking 支持	N/A	✓	部分