SKILL.md
TypeScript 命名规范
速查表
| 类型 | 规则 | 示例 |
|---|---|---|
| 变量/函数 | camelCase | userName, fetchUser |
| 类/类型 | PascalCase | UserService, ApiResponse |
| 常量 | UPPER_SNAKE | MAXRETRY, APIURL |
| 布尔 | 前缀 | isActive, hasPermission |
| 数组 | 复数 | users, items |
| 文件 | kebab-case | user-service.ts |
布尔变量前缀
| 前缀 | 语义 | 示例 |
|---|---|---|
is |
状态 | isActive, isLoading |
has |
拥有 | hasPermission, hasError |
can |
能力 | canEdit, canSubmit |
should |
建议 | shouldRefresh, shouldRetry |
will |
将要 | willUpdate, willExpire |
did |
已发生 | didMount, didChange |
常量判断
// UPPER_SNAKE: 编译时确定、不可变
const MAX_RETRY = 3
const API_URL = 'https://api.example.com'
// camelCase: 运行时计算
const currentUser = fetchUser()
常用缩写
| 缩写 | 全称 |
|---|---|
ctx |
Context |
cfg |
Configuration |
req/res |
Request/Response |
err |
Error |
fn |
Function |
ref |
Reference |
prev/next |
Previous/Next |
idx |
Index |
避免:单字母变量(除 i/j/k 和 T/K/V)