生成 URL 别名（slug）：规则与常见坑

什么场景真的需要它

博客和文档站的每篇文章都需要一个地址，slug 就是地址里可读的那一段。分类页、标签页、图片或下载文件名也常用同样的规则，让链接看起来像人写的，而不是一串编号。

页内锚点和多语言站点的路径也用它。把标题转成 ASCII 短横线后，链接在任何环境下都不会因为空格或特殊符号被截断，粘贴到聊天软件里也不会断开。链接一旦发出，后面那段就别随意改，否则收藏和外链都会失效。

• 文章与文档页面的 URL
• 分类、标签和文件名
• 页内锚点与跨语言路径

规则是什么，哪里会出意外

处理顺序是：先做 Unicode 兼容分解并去掉重音符号，再把字母、数字、下划线和汉字以外的字符全部换成连字符，然后去掉首尾连字符，最后转成小写。所以 Café 会变成 cafe，hello world 变成 hello-world。

中文会被保留，链接里会显示成一长串百分号编码，能打开但不好看也不再是纯 ASCII。日文假名不在保留范围内，会被替换成连字符，纯假名的标题可能生成空结果；韩文同理。下划线属于字母数字类，会原样留着。

• 重音符号会被去掉
• 汉字保留，假名会被替换
• 下划线不会被改成连字符

生成之后要检查什么

先看结果是不是空的。标题全是标点、表情或纯假名时，可能只剩下几个连字符甚至什么都没有，需要手动补一个。再看长度，太长的 slug 在分享和展示时会被截断，通常越短越好。

唯一性要自己保证。两篇文章标题相同时 slug 也会相同，需要加日期或序号区分；已发布的链接不要随便改，否则外部引用和搜索引擎收录都会失效。需要日文罗马字时，先用音译工具转换，再生成 slug。