不建议在内置原型上添加方法，应使用独立工具对象、ES6类或模块化方式封装；推荐纯函数工具对象，避免污染全局环境，支持Tree-shaking与类型标注。
JavaScript 中不建议直接在内置原型（如 Object.prototype、Array.prototype）上添加方法，这会污染全局环境、引发冲突或破坏迭代行为。真正安全、可维护的“封装通用工具方法”应通过独立对象、工具类或模块方式实现，原型链仅用于内部继承逻辑或特定设计场景（如自定义类的实例共享方法）。
✅ 推荐：用工具对象 + 纯函数封装
最清晰、无副作用的方式是创建一个独立的工具对象，所有方法都是静态、无 this 依赖的纯函数：
- 避免修改任何原型，完全隔离作用域
- 方法接收数据为参数，不隐式依赖调用上下文
- 天然支持 Tree-shaking（ESM 模块下）
- 易于测试、复用和类型标注（TypeScript 友好）
示例：
const utils = {
// 深克隆（简易版）
deepClone(obj) {
if (obj === null || typeof obj !== 'object') return obj;
if (obj instanceof Date) return new Date(obj);
if (obj instanceof Array) return obj.map(item => this.deepClone(item));
if (obj instanceof Object) {
const cloned = {};
for (let key in obj) {
if (Object.hasOwn(obj, key)) {
cloned[key] = this.deepClone(obj[key]);
}
}
return cloned;
}
},
<p>// 防抖
debounce(fn, delay) {
let timer;
return function (...args) {
clearTimeout(timer);
timer = setTimeout(() => fn.apply(this, args), delay);
};
},</p><p>// 格式化数字为千分位
toThousands(num) {
return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
}
};</p><p>// 使用
utils.toThousands(1234567); // "1,234,567"</p>? 进阶：用 ES6 Class + 原型方法（仅限自定义类）
如果你在封装自己的业务类（比如 Validator、ApiRequest），可将通用逻辑放在类的 prototype 上，让实例共享方法，节省内存：
立即学习“Java免费学习笔记（深入）”；
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 方法写在 class 内部，自动挂载到原型
- 实例通过
this访问自身状态，适合有上下文的操作 - 不侵入原生对象，完全可控
示例：
class Validator {
constructor(data) {
this.data = data;
}
<p>// 所有实例共享该方法
required(field) {
return this.data[field] != null && this.data[field] !== '';
}</p><p>isEmail(field) {
const emailRegex = /^[^\s@]+@[^\s@]+.[^\s@]+$/;
return emailRegex.test(this.data[field]);
}
}</p><p>const v = new Validator({ email: 'a@b.com' });
v.isEmail('email'); // true</p>⚠️ 绝对避免：给 Object/Array/String 原型加方法
以下写法看似“方便”，但风险极高：
// ❌ 危险！破坏 for...in 行为，影响其他库
Object.prototype.extend = function (other) { /* ... */ };
<p>// ❌ 导致 Array.isArray([]) 仍为 true，但某些旧代码可能误判
Array.prototype.first = function () { return this[0]; };</p><p>// ❌ String.prototype.trimEnd 在 ES2019 已存在，你的版本可能被覆盖或覆盖别人
String.prototype.capitalize = function () {
return this.charAt(0).toUpperCase() + this.slice(1);
};</p>问题包括：
– 第三方库（如 Lodash、Vue、React）可能依赖原型干净性
– for...in 遍历时意外遍历到你加的方法
– 与未来 JS 新增 API 冲突（如 Array.prototype.groupBy）
– TypeScript 类型声明不同步，导致类型错误
? 可选：用模块导出 + 解构使用（现代项目推荐）
借助 ESM，把工具函数拆成独立文件，按需导入：
// utils/array.js
export function chunk(arr, size) {
return arr.reduce((acc, _, i) =>
i % size ? acc : [...acc, arr.slice(i, i + size)], []);
}
<p>// utils/string.js
export function truncate(str, len, suffix = '…') {
return str.length <= len ? str : str.slice(0, len) + suffix;
}</p><p>// 使用页
import { chunk, truncate } from './utils/array.js';
import { truncate } from './utils/string.js'; // 同名可重命名</p>这种方式更细粒度、无运行时污染、构建工具可优化，是当前工程实践主流。
