JavaScript设计原则_JavaScript可维护代码
每个函数应只做一件事，如拆分数据处理与DOM操作，命名体现功能（如formatDate），长度控制在20行内；2. 使用清晰命名（如currentUser、isValid）减少注释依赖，关键逻辑注明“为什么”；3. 按功能模块化组织代码，如api.js处理请求，utils.js存放工具函数，使用import/export管理依赖；4. 编写可预测代码，优先纯函数，避免副作用，返回新对象而非修改参数，用const/let限制作用域，统一使用async/await处理异步。持续重构优化结构命名，提升可维护性。
写可维护的 JavaScript 代码，核心在于让代码清晰、结构合理、易于理解和修改。良好的设计原则能帮助开发者避免“一次写完永远看不懂”的问题，提升团队协作效率和长期项目稳定性。
1. 单一职责：每个函数只做一件事
一个函数或模块应专注于完成一个明确的任务。这样做能让代码更容易测试、复用和调试。
- 如果一个函数既处理数据又操作 DOM，考虑拆分成两个函数
- 命名要体现功能，比如 formatDate、validateEmail，而不是 handleData
- 函数长度尽量控制在 20 行以内，过长通常意味着职责过多
2. 使用有意义的命名和注释
变量、函数和类的名称应该清楚表达其用途，减少对注释的依赖；但关键逻辑仍需适当注释说明意图。
- 避免缩写如 usr，使用 user 或 currentUser
- 布尔值命名可用 isValid、isLoading 等前缀增强可读性
- 复杂算法或业务规则加一行注释说明“为什么”，而不是“做什么”
3. 模块化组织代码结构
将相关功能分组到独立文件或模块中，通过导入导出管理依赖，降低耦合度。
- 按功能划分模块，例如 api.js 负责请求，utils.js 存放工具函数
- 使用 ES6 模块语法（import/export）而非全局变量
- 避免创建“万能工具箱”，保持模块职责清晰
4. 编写可预测的代码行为
减少副作用，优先使用纯函数，让输入输出更可控。
- 避
免直接修改传入的对象参数，可返回新对象代替 - 尽量使用 const 和 let 替代 var，限制变量作用域
- 处理异步逻辑时统一使用 Promise 或 async/await，避免回调地狱
免直接修改传入的对象参数，可返回新对象代替基本上就这些。坚持小步重构、持续优化命名和结构，代码自然会变得更健壮、易维护。不复杂但容易忽略。
