高质量前端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]），易读性差。
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
类型安全从 TypeScript 或运行时检查开始
哪怕不用 TS，也要在关键路径做轻量类型防护：用 Array.isArray() 判数组，typeof x === 'string' 判基础类型，x == null 安全判空（等价于 x === null || x === undefined）。若项目已上 TS，接口定义要精简务实，优先用 type 描述形状，interface 用于可扩展结构；避免过度泛型或嵌套过深的类型别名。
立即学习“Java免费学习笔记（深入）”；
自动化是规范落地的唯一可靠方式
手动遵守规范不可持续。必须集成 ESLint + Prettier + Husky：ESLint 检查逻辑与潜在错误（推荐基于 @typescript-eslint/recommended 裁剪），Prettier 统一格式（缩进 2 空格、单引号、结尾分号可选），Husky 在 pre-commit 阶段自动执行 lint-staged 修复并阻断不合规提交。配置文件应纳入 Git，不依赖个人编辑器设置。
