📝 docs(typescript): clarify ts and js support boundaries
This commit is contained in:
@@ -14,14 +14,15 @@
|
||||
3. 发现安全问题(明文密钥/鉴权漏洞)立即标注或修复
|
||||
4. 不引入新依赖或工具,除非明确要求
|
||||
|
||||
## TypeScript 核心约定(不可违反)
|
||||
## TypeScript/JavaScript 核心约定(不可违反)
|
||||
|
||||
- 语言标准:优先 TypeScript;仅在纯脚本/配置场景使用 JavaScript
|
||||
- 语言标准:业务代码优先 TypeScript(`.ts/.tsx`);JavaScript(`.js/.mjs/.cjs`)仅用于脚本、配置或兼容场景
|
||||
- 类型:禁止使用 `any`;优先 `unknown`;所有公共 API 必须有明确类型注解
|
||||
- 代码风格:以仓库既有 ESLint/Prettier 配置为准;未经沟通不切换 formatter/linter
|
||||
- Import:使用 ES Module(`import`/`export`);避免 `require()`;按 外部 → 内部 → 相对路径 分组
|
||||
- 命名:文件 `kebab-case.ts`;类/接口/类型 `PascalCase`;函数/变量 `camelCase`;常量 `UPPER_WITH_UNDER`;私有成员 `_camelCase`
|
||||
- 命名:文件 `kebab-case.ts/.js`;类/接口/类型 `PascalCase`;函数/变量 `camelCase`;常量 `UPPER_WITH_UNDER`;私有成员 `_camelCase`
|
||||
- 异步:优先 `async/await`;避免裸 `.then()` 链;错误必须处理
|
||||
- JavaScript 质量底线:必须通过 ESLint;推荐启用 `@ts-check` + JSDoc 做静态检查
|
||||
|
||||
## 安全红线(不可触碰)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user