JavaScript插件核心是隔离作用域、显式通信、可配置入口；须用IIFE或ES模块封装，配置通过options对象传入并设默认值，返回含destroy/update等方法的实例，生命周期由调用方控制。
JavaScript 插件不是写个函数丢进全局就行，核心在于「隔离作用域 + 显式通信 + 可配置入口」。没有这三点，所谓“可扩展”很快会变成维护噩梦。
插件必须用立即执行函数（IIFE）或 ES 模块封装
直接挂 window 或 this 上的变量/函数极易冲突，尤其在多插件共存场景（比如 CMS 后台、低代码平台）。IIFE 是最轻量、兼容性最好的隔离方式。
- 不推荐：
function myPlugin() { ... }—— 全局污染，无法控制加载顺序和依赖 - 推荐：
(function (root, factory) { if (typeof define === 'function' && define.amd) { define([], factory); } else if (typeof module === 'object' && module.exports) { module.exports = factory(); } else { root.MyPlugin = factory(); } })(typeof window !== 'undefined' ? window : this, function () { 'use strict'; return function (options) { // 插件主体 }; }); - 现代项目优先用 ES 模块：
export default class MyPlugin，但需确认打包工具支持 tree-shaking 和动态导入
构造函数必须接受 options 对象，禁止硬编码配置
可扩展性的第一道门槛是「配置即接口」。所有行为开关、回调、选择器、超时时间都得从 options 进来，而不是写死在源码里。
-
options至少应包含：el（目标 DOM 节点）、onInit（初始化回调）、disabled（开关）、delay（防抖毫秒数） - 必须提供默认值，并用
Object.assign({}, defaults, options)合并，避免意外覆盖原始对象 - 禁止出现：
if (mode === 'debug') { console.log(...); }—— 应改为if (options.debug) { ... }
暴露实例方法而非仅返回布尔值或 void
插件一旦初始化，就得留出运行时干预能力。只返回 true 或什么都不返回，等于锁死了二次交互可能。
立即学习“Java免费学习笔记（深入）”；
- 正确做法：返回一个实例对象，含
destroy()、update(newOptions)、enable()、disable()等方法 - 示例：
const inst = new MyPlugin({ el: document.querySelector('#target'), delay: 300 }); inst.destroy(); // 清理事件监听、定时器、DOM 插入内容 inst.update({ delay: 500 }); - 关键点：所有副作用（
addEventListener、setTimeout、innerHTML）必须被实例持有并可撤回，否则内存泄漏不可避免
不要自行管理生命周期，交由调用方决定何时 init/destroy
插件不该假设自己该在 DOMContentLoaded 执行，也不该自动监听 resize 或 scroll —— 这些属于业务逻辑，不是插件职责。
- 常见错误：
document.addEventListener('DOMContentLoaded', () => { new MyPlugin(...); });—— 把时机判断权让渡给使用者更安全 - 正确姿势：插件只做「纯函数式初始化」，把 DOM 节点、事件绑定、副作用清理全交给调用方协调
- 如果真需要响应式能力，应提供
observe选项，由插件内部用MutationObserver或ResizeObserver实现，且默认关闭
最难的部分不是写功能，而是克制——忍住不加“方便”的自动初始化、不塞进“贴心”的全局快捷键、不默认开启所有特性。可扩展性本质是留白的艺术，留多少、怎么留，取决于你预判使用者会往哪个方向走。
