Slug 生成器

中文标题会得到什么

工具不做拼音转写。汉字和中文标点会被删掉（删掉的位置按空格处理），留下来的只有标题里的英文、数字，以及下文映射表中的符号；全角字母和数字会先换成半角再保留。以下是默认选项（连字符、小写、修剪）的实际结果：

• 如何用 Python 3.12 解析 JSON → python-3-12-json
• Vue 3 + Vite 项目配置指南 → vue-3-plus-vite（+ 换成了 plus）
• 微信小程序 setData 性能优化 → setdata
• 同一个标题关闭「小写」：微信小程序 setData 性能优化 → setData
• 分隔符选下划线：如何用 Python 3.12 解析 JSON → python_3_12_json

第三个例子只剩一个词，已经看不出文章讲什么。这时可以先写一个英文标题或拼音，再交给工具。带声调的拼音可以直接粘贴，声调符号在 NFD 分解后会被去掉：

• Rúhé yòng Python jiěxī JSON → ruhe-yong-python-jiexi-json

¥ 与全角字符

人民币和日元都写作 ¥（U+00A5），工具按映射表一律换成单词 yen，不会区分货币：

• 价格 ¥99 起 → yen-99

全角的 ￥（U+FFE5）、％ 和全角字母、数字会先按 NFKC 换成半角，再查映射表，所以结果与半角输入相同：

• 价格 ￥99 起 → yen-99
• Ｎｏｄｅ．ｊｓ ２０ 入门 → node-js-20

全角空格（U+3000）先换成半角空格，被删掉的汉字也按空格处理，中文夹在英文中间、没有半角空格时，英文单词也会分开：

• Hello　World（中间是全角空格）→ hello-world
• Vue3入门Vite教程 → vue3-vite

字符映射

符号换成独立的单词，Rock & Roll 得到 rock-and-roll，Tom&Jerry 得到 tom-and-jerry。带附加符号的字母去掉符号（先做 Unicode NFD 分解，再删去组合附加符号）：é → e、ñ → n、Łódź → lodz、Tiếng Việt → tieng-viet。不能分解的字母按第二张表替换，取值参考 sindresorhus/transliterate。大写字母保持大写（Ø → O、Œ → OE），开启「小写」时再转为小写。

限制

• 去掉附加符号时不按语言区分：德语 ä ö ü 变成 a o u（不是 ae oe ue），土耳其语 İ 变成 I。
• 非拉丁文字会被删除。开启「修剪」时，只输入中文、日文或韩文会得到空结果；关闭「修剪」时只剩一个分隔符：北京 → -。
• 字母或数字后面、字母前面的撇号（'、’、‘、ʼ、ʻ、´、′）直接删除：John's Guide → johns-guide，1990's Music → 1990s-music；旁边是空格，或者在文字开头、结尾时，撇号当作分隔符：rock 'n' roll → rock-n-roll。
• 关闭「修剪」时，开头和结尾的分隔符会保留：Hello World! → hello-world-。
• 不做拼音转写，也不按汉字读音生成单词。
• 不删除 a、the、of 这类虚词，也没有长度上限，长标题会得到长 slug；如果 CMS 限制 slug 长度，请手动截短。
• 一次只转换一段文字，换行按空格处理，粘贴多行标题会得到一个很长的 slug。
• # 换成单词 hash，所以 C# 得到 c-hash，不是 c-sharp；这类名称请先改写再转换。

Slug 的使用场景

• 博客文章 URL： /blog/how-to-use-slugs
• 商品页面： /products/red-running-shoes
• 文件名： my-important-document.pdf
• 数据库键： 无空格的可读唯一标识符。

同一套规则对只在标点、大小写上不同的标题会给出同一个 slug。