• 教程
• 文档

在 JavaScript 的 ES6 Class 体系中，静态方法（static methods）与实例方法（instance methods）是两类用途截然不同的方法：前者挂载在类（构造函数）自身上，服务于类型层面的工具操作；后者挂载在类的prototype上，被所有实例继承并直接作用于具体对象。本文以 30 seconds of code 仓库的 static-instance-methods.md 为骨架，结合仓库内矩阵数据结构、单位换算器、Stack 等真实 snippet，讲透两者的定义、区别、this绑定差异、典型实战场景与选择准则，读完你即可在自己的类设计中准确决策「该方法该不该加static」。

核心概念：静态方法与实例方法

在 ES6 Class 出现之前，JavaScript 开发者通过构造函数 + 原型链模拟面向对象；ES6 之后，class语法糖让两类方法的表达变得直观：

• 静态方法属于类本身，不作用于类的实例。它们不能被实例调用，只能通过类名调用。最常见的用途是工具函数，例如创建对象、克隆对象、类型判断等与「某个具体实例的状态」无关的操作。
• 实例方法属于类的原型（prototype），被所有实例通过原型链继承。它们作用于实例，通常需要读写实例自身的属性，因此必须通过实例调用。

原文档用数组这一最熟悉的例子做出了最直白的区分：

const arr = [1, 2, 3]; // An Array instance Array.isArray(arr); // Static method of Array arr.push(4); // Instance method of Array

• Array.isArray(arr)是Array的静态方法：它判断某个值是否为数组，与「哪个数组」无关，只需要类型本身，因此挂在Array上、通过类名调用；
• arr.push(4)是Array.prototype上的实例方法：它要修改arr这个具体实例的内部状态，因此必须由实例调用。

在 ES6 类中，用static关键字声明静态方法，而没有static修饰的方法默认就是实例方法：

class MyClass { static staticMethod() { return 'I live on the class itself'; } instanceMethod() { return 'I live on MyClass.prototype and act on instances'; } } MyClass.staticMethod(); // 'I live on the class itself' new MyClass().instanceMethod(); // 'I live on MyClass.prototype and act on instances' MyClass.instanceMethod(); // TypeError: MyClass.instanceMethod is not a function new MyClass().staticMethod(); // TypeError: (intermediate value).staticMethod is not a function

两个TypeError恰好印证了原文档的论断：实例方法不可通过类名调用，静态方法不可通过实例调用。

底层原理：类、构造函数与原型链

要真正理解两类方法的差异，需要回到 JavaScript 的机制本身。仓库中的 classical-vs-prototypal-inheritance.md 对此有系统讲解：经典继承以「类」为抽象单元，原型继承以「对象」为抽象单元，而 ES6class本质上是基于原型链的语法糖。

从源码结构看，一个 ES6 类经过运行时处理后，类的名字本身就是一个构造函数（函数对象）：

• 用static声明的方法，作为自有属性直接挂载到这个构造函数对象上，因此只能通过ClassName.method()访问；
• 普通方法则被写入ClassName.prototype对象，实例通过内部[[Prototype]]（即__proto__）链式查找，因此所有new ClassName()出来的实例都能访问到同一份方法定义，而不会为每个实例复制一份。

这也解释了原文档中「实例方法属于类原型、被所有实例继承」的表述：实例自身不拥有方法副本，方法查找沿原型链进行。Stack 数据结构的 snippet>class Stack { constructor() { this.items = []; } push(item) { this.items.unshift(item); } pop() { return this.items.shift(); } peek() { return this.items[0]; } isEmpty() { return this.items.length === 0; } } const stack = new Stack(); stack.push('apples'); stack.push('oranges'); stack.push('pears'); stack.isEmpty(); // false stack.peek(); // 'pears' stack.pop(); // 'pears'

关键区别速查表

深入：两类方法中的this绑定差异

两类方法在this语义上的差异是理解其行为边界的关键。仓库中的 this.md 系统梳理了this的绑定规则，其中与本文直接相关的有两条：

• 对象方法中this指向被调用的对象；
• 构造调用中this绑定到新构造的对象。

套用到类上：

• 调用实例方法时，this指向调用它的那个实例（这一点同样适用于定义在原型链上任意位置的方法，this.md原文：「This applies to methods defined anywhere in the object's prototype chain」）；
• 调用静态方法时，this指向类（构造函数）本身——不过静态方法通常不依赖this，它们更像「命名空间下的纯函数」。

一个直接推论：静态方法内部不能直接访问this.someInstanceField，因为实例字段只存在于实例上；反过来，实例方法内部也不该试图通过this做类级别的工作。如果确实需要在实例方法内调用静态方法，应显式使用类名，例如ClassName.staticMethod()，而不是this.staticMethod()（后者会被当成实例方法查找而失败）。

实战一：静态工厂方法——Matrix 数据结构的from/zeroes/identity

静态方法最常见的实战场景之一是工厂方法：不直接new，而是通过语义化的静态方法创建并初始化实例。仓库中的 matrix-data-structure.md 给出了教科书式的例子——Matrix类的构造函数接受二维数组或维度对象，而三个静态方法负责按不同语义生成矩阵：

class Matrix { constructor(data) { if (Array.isArray(data)) { this.rows = data.length; this.cols = data[0].length; this.data = data; } else { this.rows = data.rows; this.cols = data.cols; this.fill(0); } } static from({ rows, cols }) { return new Matrix({ rows, cols }); } static zeroes({ rows, cols }) { return new Matrix({ rows, cols }); } static identity({ size }) { return new Matrix( Array.from({ length: size }, (_, i) => Array.from({ length: size }, (_, j) => (i === j ? 1 : 0)) ) ); } } Matrix.from({ rows: 3, cols: 3 }); // 3x3 全 0 矩阵 Matrix.zeroes({ rows: 2, cols: 4 }); // 2x4 全 0 矩阵 Matrix.identity({ size: 3 }); // 3x3 单位矩阵，对角线为 1

注意这三个静态方法都通过new Matrix(...)返回全新实例，这正是原文档所说「静态方法常用于创建或克隆对象」的落地形态：调用者无需关心构造细节，from、zeroes、identity从语义上就把「以维度初始化」「全零」「单位矩阵」区分开了。而fill、copy等则作为实例方法，操作已经存在的矩阵数据。

实战二：动态生成静态方法——单位换算器的fromMeters/fromFeet…

静态方法不一定要手写。仓库中的 unit-converter-data-structure.md 展示了用Object.defineProperty()依据单位表批量生成静态方法与实例 getter 的技巧：每个单位同时生成一个fromXxx静态工厂方法（把外部值换算成内部基准单位厘米）和一个同名实例 getter（把内部厘米值换算成目标单位）：

class Distance { static conversions = { inches: 2.54, feet: 30.48, yards: 91.44, miles: 160934.4, centimeters: 1, meters: 100, kilometers: 100000, }; constructor(cm) { this.cm = cm; } } Object.entries(Distance.conversions).forEach(([unit, conversion]) => { Object.defineProperty( Distance, `from${unit.charAt(0).toUpperCase() + unit.slice(1)}`, { get: function () { return value => new Distance(value * conversion); }, } ); Object.defineProperty(Distance.prototype, unit, { get: function () { return this.cm / conversion; }, }); }); const distance = Distance.fromMeters(10); distance.feet; // 32.808398950131235 distance.centimeters; // 1000

这个例子同时呈现了两类方法的经典配合：

• Distance.fromMeters(10)、Distance.fromFeet(...)等静态方法是入口工厂，负责「从外部单位创建实例」；
• distance.feet、distance.meters等实例 getter是出口，负责「读取实例在当前单位下的数值」。

conversions静态字段（static class field）同样属于类自身，可被静态方法及外部直接读取，体现了静态成员作为「类型级配置/常量」的定位。

实战三：实例方法操作内部状态——Stack、Linked List 等数据结构

当方法必须读写「这一个实例」的数据时，实例方法是唯一正确的选择。除上文 Stack 外，仓库中的>赞分享

• 30 Seconds of Interviews 深度解析：JavaScript 静态方法（Static Method）与实例方法（Instance Method）的区别与实战

  30 Seconds of Interviews 深度解析：JavaScript 静态方法（Static Method）与实例方法（Instance Metho

  教程前端

• 30 seconds of code 深入解读：JavaScript 函数方法 call()、apply() 与 bind() 完整指南

  30 seconds of code 深入解读：JavaScript 函数方法 call 、apply 与 bind 完整指南 Function.prototy

  教程文档

• Civitai 事件引擎 Redis 缓存排查指南：redis-inspect 技能全解析

  Civitai 事件引擎 Redis 缓存排查指南：redis inspect 技能全解析 本文围绕 apps/event engine/.claude/ski

  教程文档