📂 二、其他常见 .md 文件类型 ​

除 README.md 外，项目中还可能包含以下 Markdown 文件：

好，这个问题问得非常“规范派” 👍 我直接给你一份前端（偏大厂 / 团队协作级）命名规范速查表，覆盖你刚才提到的：

• 方法
• 变量
• 是否（boolean）
• 常量
• 组件
• 事件
• 枚举 / 状态
• 接口 / 类型

你可以直接拿去当 项目规范文档的一页 用。

好，这个我给你 重新系统写一份「偏大厂 / 团队协作级」的 JS 前端命名规范速查表。 不是那种“变量用小驼峰就完事”的水文，而是 能直接进团队规范 / Code Review 用的版本。 我会把你提到的 isNon 这种命名 单独拎出来讲清楚：什么时候对、什么时候坑。

✅ JavaScript / Frontend 命名规范速查表（团队协作级） ​

目标：可读性 > 可维护性 > 可扩展性 > 避免歧义

核心原则一句话： “看到名字就知道它是什么、表示什么状态、是否可变、是否是布尔、是否是集合”

一、总体命名风格总览 ​

二、变量命名规范（最重要） ​

1️⃣ 普通变量（名词 + 语义） ​

❌ 错误

let data
let info
let temp
let result

✅ 正确

let userInfo
let orderList
let responseData
let cachedToken

🚫 禁止使用无语义词：data / temp / obj / arr

2️⃣ 集合 / 数组命名（必须是复数） ​

const userList = []
const userIdMap = new Map()
const selectedIds = new Set()

三、布尔值命名（重点 + 易踩坑） ​

✅ 标准布尔前缀（只用这 4 个） ​

const isLoading = true
const hasError = false
const canSubmit = true

⚠️ 关于你提到的：isNonXXX 命名 ​

❌ 强烈不推荐（团队规范里会被打回） ​

isNonEmpty
isNonAdmin
isNonValid

❗ 问题在哪？

✅ 推荐替代方案（明确 + 正向） ​

📌 黄金规则：布尔命名只表达“正向状态”

四、函数命名规范（动词开头） ​

1️⃣ CRUD 动词表（团队统一） ​

getUserInfo()
fetchOrderList()
validateForm()
parseJwtToken()

2️⃣ 函数命名 = 动词 + 对象 + 条件 ​

❌

handle()
doIt()
process()

✅

handleLoginSubmit()
processPaymentResult()
syncUserProfile()

五、事件 & 回调命名规范 ​

function handleSubmitClick() {}
function onSocketMessage() {}

六、常量 & 枚举命名 ​

1️⃣ 常量（全部大写） ​

const MAX_PAGE_SIZE = 50
const DEFAULT_TIMEOUT = 3000

2️⃣ 枚举对象 ​

export const USER_ROLE = {
  ADMIN: 'admin',
  USER: 'user',
  GUEST: 'guest',
}

七、类 / Service / Hook 命名 ​

类（名词） ​

class UserService {}
class AuthManager {}
class CacheStore {}

React Hooks ​

useUserInfo()
useAuthStatus()
useScrollPosition()

❌

useGetUser()
useFetchData()

八、临时变量（允许但有限制） ​

for (let i = 0; i < list.length; i++) {}

允许：

• i / j
• idx
• len

❌ 禁止用于业务逻辑

九、文件 & 目录命名（大厂常规） ​