高质量前端javascript代码需语义化命名、禁用var、合理解构、类型防护及eslint+prettier+husky自动化保障。

高质量的现代前端 JavaScript 代码,不是写得“能跑就行”,而是让人一眼看懂、改起来放心、加功能不踩坑。核心在于用规范降低认知负担,靠工具保障落地效果,而不是靠人盯人。
命名必须语义化,且严格区分类型
变量和函数用 camelCase(如 isModalOpen、fetchUserProfile),类名和组件名用 PascalCase(如 UserCard、ApiService),常量全大写下划线(如 DEFAULT_TIMEOUT_MS)。布尔值建议带 is、has、should 前缀,避免歧义;禁止用 data、info、obj 这类无信息量的命名。
强制使用 const/let,禁用 var
var 的变量提升和函数作用域容易引发隐蔽 bug,现代代码一律用 const 优先,仅在需要重新赋值时才用 let。解构赋值要合理:对象解构推荐带默认值({ name = 'anonymous', id } = user),数组解构慎用下标跳过(如 [,,third]),易读性差。
类型安全从 TypeScript 或运行时检查开始
哪怕不用 TS,也要在关键路径做轻量类型防护:用 Array.isArray() 判数组,typeof x === 'string' 判基础类型,x == null 安全判空(等价于 x === null || x === undefined)。若项目已上 TS,接口定义要精简务实,优先用 type 描述形状,interface 用于可扩展结构;避免过度泛型或嵌套过深的类型别名。
自动化是规范落地的唯一可靠方式
手动遵守规范不可持续。必须集成 ESLint + Prettier + Husky:ESLint 检查逻辑与潜在错误(推荐基于 @typescript-eslint/recommended 裁剪),Prettier 统一格式(缩进 2 空格、单引号、结尾分号可选),Husky 在 pre-commit 阶段自动执行 lint-staged 修复并阻断不合规提交。配置文件应纳入 Git,不依赖个人编辑器设置。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











