# 风格与约定

- Vue 3 Composition API，优先 `<script setup>`；组件标签使用小写 kebab-case。
- TypeScript 优先明确类型并为公共 API 写 JSDoc；Promise 使用 async/await。
- Less 使用嵌套规则，属性尽量简写，优先 rem；属性按名称长度排序，类名简短。
- 文本文件使用 UTF-8；遵循仓库 `.eslintrc.js`。ESLint 9 当前使用旧式 `.eslintrc` 时，设置 `$env:ESLINT_USE_FLAT_CONFIG = 'false'` 后再运行。
- 不随意重命名公共类型，不无故增加依赖；不添加测试，除非用户明确要求。