目录

TypeScript 里常见的命名规范大致如下:

文件/模块

组件文件:PascalCase,如 UserProfile.tsx

工具/工具库文件:kebab-case 或 camelCase,如 date-utils.ts、formatData.ts(社区里 kebab-case 更常见于工具类,camelCase 常见于函数文件,看项目约定)

变量、函数、方法

camelCase:userName、fetchUserData()

布尔值常用 is、has、can、should 前缀:isLoading、hasError

类、接口、类型、枚举

PascalCase:class UserService、interface UserConfig

接口不加 I 前缀(IUser 是旧式 C# 风格,TS 社区主流不推荐)

类型别名同样 PascalCase:type UserRole = 'admin' | 'user'

枚举成员用 PascalCase 或全大写 SNAKE_CASE:enum Color { Red, Blue }

常量

全大写 SNAKECASE:const MAXRETRY_COUNT = 3

但如果是模块内普通常量、配置对象,很多人也用 camelCase,只有“真正的硬常量”才全大写

泛型参数

单字母大写:T、K、V,或多个时用语义化 PascalCase:TData、TError

其他约定

私有类成员用 # 前缀或 private 关键字,不用 _ 开头(_ 前缀现在一般留给“未使用参数”,如 _req)

React 组件名必须 PascalCase,hook 用 use 前缀 camelCase:useFetchUser

最省事的做法是直接用 ESLint 的 @typescript-eslint/naming-convention 规则把约定固化下来。如果项目有 Airbnb 或 Google 的 TS 风格指南做底座,跟着它走就行。