📝 docs(typescript): clarify ts and js support boundaries

This commit is contained in:
csh
2026-02-25 13:19:48 +08:00
parent 1f46203299
commit 9ac8a4c8a4
5 changed files with 29 additions and 11 deletions
+4 -3
View File
@@ -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 做静态检查
## 安全红线(不可触碰)