WebTool

文本与开发系列 · 第 2 章

命名规范:camelCase、snake_case、kebab-case 怎么选?

WebTool 团队 · 发布于 2026-09-08 · 命名规范 / 代码风格 / 团队协作

命名法没有绝对优劣,只有「在该生态里的约定俗成」:JS/Java 用 camelCase,Python/数据库用 snake_case,URL 与 CSS 用 kebab-case,类名普遍用 PascalCase。真正伤效率的是同一项目里混用。 本站提供大小写命名转换驼峰下划线互转工具。

四种主流写法

命名法 示例 主要地盘
camelCase(小驼峰) userName JS/Java/Go 变量与函数、JSON 字段
PascalCase(大驼峰) UserName 各语言的类/组件/类型名
snake_case(下划线) user_name Python/Ruby 变量、数据库列名、环境变量(大写 USER_NAME
kebab-case(短横线) user-name URL、CSS 类名、CLI 参数

跨系统对接的转换策略

最常见的一条链路:数据库 snake_case → 后端 → JSON camelCase → 前端组件。建议:

  • 序列化层集中转换(如 Java 的 Jackson SNAKE_CASE 策略、Python 的 pydantic alias),而不是每个字段手写映射。
  • 选定方向后全链路统一:JSON 用 camelCase 就在所有接口保持一致,别这个接口 userName 那个接口 user_name
  • 环境变量永远大写蛇形:DATABASE_URL

比风格更重要的三件事

  1. 一致性 > 风格本身。一个全用 snake_case 的项目远好于两种混用的项目;接手既有项目时跟随现状,不要半路换风格。
  2. 布尔用 is/has/can 开头isActive 一眼可知类型,status 则不行。
  3. 集合用复数users 是数组,user 是单个对象,接口文档里能省掉大量歧义。

最后更新:2026-09-08