Appearance
其他框架规范
除 Vue 和 React 外,团队可能会接触到其他前端框架和工具库,以下列出通用的使用规范
Svelte
- 组件文件使用 PascalCase 命名,如
UserCard.svelte - 遵循 Svelte 官方推荐的响应式语法
- 样式默认 scoped,无需额外配置
Angular
- 遵循 Angular CLI 默认的项目结构
- 使用 Angular 官方的风格指南进行开发
- 组件、服务、模块等命名遵循官方约定
jQuery / 传统项目
对于维护中的老旧项目:
- 不主动引入新的 jQuery 代码,逐步使用原生 API 替代
- 事件绑定统一使用
on方法,避免使用click()、change()等快捷方式 - DOM 操作前做好元素存在性判断
- 避免过度嵌套回调,使用 Promise 或 async/await 改善代码结构
通用原则
无论使用何种框架,以下原则均需遵守:
- 组件化思维:将 UI 拆分为独立、可复用的组件
- 单一职责:每个组件/模块只负责一个功能
- 状态管理:合理划分本地状态和全局状态
- 类型安全:能用 TypeScript 的项目尽量使用 TypeScript
- 代码风格:统一使用 ESLint + Prettier 规范代码格式
- 文档注释:公共 API 和复杂逻辑需添加必要的注释说明
