这个工具做什么
同一条信息在不同语言和不同团队里有不同的书写约定。JavaScript 变量习惯用 camelCase,类名习惯用 PascalCase,Python 与数据库字段习惯用 snake_case,CSS 类名习惯用 kebab-case,常量习惯用 CONSTANT_CASE,配置文件里还常见 dot.case。手工改名既费时间又容易漏掉某一种形式,这个工具把一次分词的结果按 8 套规则分别拼出来,改一处就能全部对齐。
它的核心不是一个替换表,而是分词:先把输入拆成一个个独立的词,再按各风格重新组合。分词是否合理直接决定结果是否可用,所以下面「结果怎么解读」一节把规则写得很细。拆词之后,8 种风格只是连接符和大小写规则不同,本质上是同一组词的不同写法。
所有处理都在浏览器本地完成,输入不会上传,也不写入本地存储。非 ASCII 字符(中文、日文、全角标点等)原样保留在所属的词里,不做拼音或音译转换,因此中文标识符转换后仍然是中文,只是连接符与大小写规则生效于周围的英文部分。
还有一点需要先说清楚:工具不会猜测你的意图。它按固定规则机械分词,得到的是「按规则推导出的结果」,而不是「作者当初想要的结果」。遇到缩写词、数字、连续分隔符这类有歧义的输入时,结果可能与预期不同,这在最后一节会具体说明。
怎么用
在左侧输入框里填写标识符,每行一个。输入后右侧会自动更新,8 种风格同时给出,不需要按转换按钮。单行和多行用的是同一套逻辑:每个非空行独立分词、独立拼接,输出也按行对齐,第 3 行的结果永远对应输入的第 3 行。
- 空行会原样保留。输入中间隔一个空行,输出对应的位置也是空行;这一点在处理从表格或代码块里复制出来的批量数据时很重要,行号不会错位。
- 「载入示例」填入 5 行有代表性的输入,覆盖驼峰、缩写词、下划线、数字和全大写常量,可以直接对照右侧看规则怎么生效。
- 每种风格右上角都有「复制」按钮,复制的是该列全部行(含空行),可以直接粘贴进代码文件替换原来的字段名。
- 「清空」同时清空输入与 8 列结果,状态回到初始提示。
如果只是改名一两个字段,直接在输入框里改更容易;如果是把一个模块里的几十个字段统一改成另一种风格,建议先把它们从代码里摘出来按行粘贴,复制结果后再整体替换,避免逐条手改时出现大小写不一致。
结果怎么解读
分词按以下顺序进行。第一步,把下划线 _、连字符 -、点 .、空格、正斜杠 /、反斜杠 \ 以及制表符都视为分隔符,连续多个分隔符合并成一处,不产生空词。第二步,在剩下的每一段里寻找驼峰边界,规则有三条:小写字母或数字后面紧跟大写字母时切开;连续大写字母后面紧跟小写字母时,在最后一个大写字母前切开;字母与数字之间不切,数字留在它前面那个词里。第三步,去掉空词,得到最终词表。
按这三条规则,user2Name 会被切成 user2 与 Name:字母与数字之间不切,所以 2 跟着 user;数字后紧跟大写 N,命中第一条规则,于是切开。同理,HTTPServer 切成 HTTP 与 Server,因为 P 后面跟着小写 e,需要在最后一个大写字母 S 之前切开。get_user-profile.name 切成 4 个词:get、user、profile、name。
切好词之后,8 种风格的拼法分别是:camelCase 首个词全小写、其余词首字母大写后直接相连;PascalCase 所有词首字母大写后相连;snake_case 全部小写、用下划线连接;kebab-case 全部小写、用连字符连接;CONSTANT_CASE 全部大写、用下划线连接;dot.case 全部小写、用点连接;space case 全部小写、用单个空格连接;Title Case 每个词首字母大写、用单个空格连接。
以 user2Name 为例,8 个结果依次是 user2Name、User2Name、user2_name、user2-name、USER2_NAME、user2.name、user2 name、User2 Name。可以看出词边界一旦确定,剩下的只是机械拼接,所以检查结果是否合理,重点应放在分词是否与你理解的一致,而不是逐个字母去核对。
常见的几种情况
缩写词的边界有歧义
HTTPResponseCode 会切成 HTTP、Response、Code,结果符合预期。但 ABc 这种连续大写后接小写的输入,规则会切出 A 与 Bc;如果本意是 AB 与 c,工具无法分辨。规则本身是确定的,问题在于输入丢失了词边界信息。遇到缩写连写时,最稳妥的做法是先用分隔符把边界写清楚,例如把 ABc 写成 AB_c,再转换,这样结果不再依赖推断。
已经混合了大小写和分隔符
输入里同时出现下划线和大驼峰不会出错,两种边界都会被识别,重复的分隔符也不会生成空词。__get__User__Name__ 的结果与 getUserName 完全一致。这一点在整理历史遗留代码时很有用:不必先手工清理格式,直接粘进来即可。
数字的位置
数字始终跟着它前面的词,因此 sha256Hash 会切成 sha256 与 Hash 两个词,转成 snake_case 后是 sha256_hash,不会拆成 sha 与 256。2faCode 这种数字开头的写法会切成 2fa 与 Code。需要注意,部分语言不允许标识符以数字开头,转换结果能否编译要通过语言自身的规则验证,工具不做语法检查。
中文与全角字符
中文不属于 ASCII 字母,不参与驼峰判断,会原样留在词里。例如 用户ID 中,ID 是大写字母但它前面也是非 ASCII 字符,不构成「小写转大写」的边界,因此整体保持为一个词。转成 snake_case 后仍是 用户id。如果需要在中文与英文之间断开,请先用分隔符标明。
使用限制与提醒
单次输入上限为 20,000 字符、500 行,以先达到的条件为准。超过上限时工具不会截断后继续转换,而是提示当前字符数或行数,并保留上一次的结果。批量重命名一个大型项目时,建议分文件、分批次处理,每批复制前先核对行数是否与输入一致。
这个工具只负责文本层面的改写,不检查结果是否是合法标识符,也不检查是否与已有名称冲突。某些语言的保留字、以数字开头的名字、包含点号的名字在不同语境下合法性不同,转换完仍需要按目标语言的规则确认。它也不做语义判断,不会把 getUserName 改成 fetchUserName 这类同义替换。
最后提醒两点。第一,大小写转换会改变字符串内容,如果这个标识符同时被用作序列化后的字段名、接口参数或数据库列名,改名需要同步修改对端,否则会出现读不到字段的问题。第二,转换结果不保留原始写法,一旦覆盖原文件就无法从结果反推出输入,需要保留原始版本时请先备份或使用版本控制。