如何生成不断词的SEO标题?strman-java的truncate与safeTruncate智能截断技巧
如何生成不断词的SEO标题?strman-java的truncate与safeTruncate智能截断技巧
在生成 SEO 标题、文章摘要或列表卡片描述时,字符串截断是个高频痛点:直接按长度切割会把单词拦腰斩断,生成类似 “A Javascrip...” 的残缺标题,既影响用户点击,也损害搜索引擎收录质量。本文介绍零依赖的 Java 8 字符串处理库 strman-java,通过 truncate 与 safeTruncate 两个方法实现“安全断词”的智能截断,帮助你快速生成规范的 SEO 标题。
一、先搞清楚问题:为什么标题不能随便截断?
想象一下搜索结果页出现这样的标题:
- ❌
A Javascrip...(半截单词,观感糟糕) - ❌
如何快速学习Pyth...(中文同理,语义被截断) - ✅
A Javascript string manipulation library...(完整词语 + 省略号)
SEO 标题 的核心诉求是:长度可控 + 语义完整。搜索引擎通常只展示标题的前 50~60 个字符,后端系统需要在 Java 服务里对长标题做截断,而“在词边界处截断”正是专业做法。
strman-java 的定位是 A Java 8 string manipulation library,没有任何第三方依赖,适合直接嵌入 Spring Boot、Servlet 等后端项目。
二、两个截断方法:truncate vs safeTruncate 怎么选?
strman 库的核心实现都在 Strman.java 中,两个方法各司其职:
| 方法 | 行为 | 截断结果示例 | 适用场景 |
|---|---|---|---|
truncate(value, length, filler) |
按字符位置硬截断 | A Javascrip... |
URL slug、固定宽度字段 |
safeTruncate(value, length, filler) |
在完整单词处截断 | A Javascript... |
SEO 标题、摘要展示 |
🎯 safeTruncate:不断词的智能截断
源码位于 Strman.java#L872-L893,其工作原理只有三步:
- 调用 words 把字符串按空白符拆分成单词数组;
- 逐个累加单词,只要“已选内容 + 下一个单词 + 填充符”不超过
length,就继续保留; - 一旦超界立即停止,并追加填充符(如
...)。
效果非常直观:
Strman.safeTruncate("A Javascript string manipulation library.", 16, "...");
// => "A Javascript..."
而同样输入用 truncate 处理,就会得到生硬的 A Javascrip...。
✂️ truncate:精确到字符的硬截断
truncate 定义在 Strman.java#L938-L947,逻辑极简:截取前 length - filler.length() 个字符,再拼上填充符。
它适合不关心词边界的场景,比如:
- 生成数据库定长字段
- 移动端固定行数的占位文本
两个方法都内置了防御性检查:length 为 0 时返回空串,length 不小于原串长度时原样返回,输入为 null 则抛出 IllegalArgumentException,业务侧可以放心调用。
三、实战:生成规范的 SEO 标题
场景 1:列表页标题(推荐 safeTruncate)
String title = "Java 8 字符串处理库:完整指南与最佳实践";
String seoTitle = Strman.safeTruncate(title, 30, "...");
保证输出的标题不会在词语中间断开,同时长度严格受控。
场景 2:与 collapseWhitespace 组合使用
原始数据常来自用户输入,可能夹杂多余空格。先用 collapseWhitespace 折叠连续空白(见 Strman.java#L141-L144),再截断:
String raw = " 如何 快速 学习 Java ? ";
String seoTitle = Strman.safeTruncate(Strman.collapseWhitespace(raw), 20, "…");
场景 3:配合 slugify 生成 URL
SEO 三件套是标题、描述与 URL。strman 提供 slugify 把标题转为 URL 友好的 slug,再配合 truncate 控制 URL 长度,一套组合拳搞定。
四、行为细节:官方测试用例帮你避坑
阅读 StrmanTests.java#L658-L681 中的测试,能精确掌握边界行为:
| 输入 | 参数 | 输出 | 说明 |
|---|---|---|---|
foo bar |
length=0 |
"" |
长度为 0 直接返回空串 |
foo bar |
length=3,filler . |
. |
空间不够放任何完整单词时只剩填充符 |
foo bar |
length=7 |
foo bar |
不超长则原样返回 |
| 长句 | length=14,filler ... |
A... |
只保住第一个词 |
几个容易踩的坑:
- ⚠️
filler的长度会计入总长度预算,填...(3 个字符)就只剩length - 3给正文; - ⚠️
safeTruncate以空白符为词界,中文连续无空格文本不会命中“断词保护”,可退化为truncate硬截断; - ✅ 想自定义分词规则时,可先用 words(value, delimiter) 指定分隔符预分词。
五、快速上手:零依赖引入
strman 已在 Maven Central 发布,构建文件中加入依赖即可(详见 README.md):
<dependency>
<groupId>com.shekhargulati</groupId>
<artifactId>strman</artifactId>
<version>0.4.0</version>
</dependency>
项目采用 Gradle 构建,可通过 gradlew 与 settings.gradle 本地构建;历史版本变更记录见 changelog.md,许可证为 MIT(LICENSE.txt),可自由商用。
六、总结:一张表记住选型
| 你的需求 | 推荐方法 | 一句话理由 |
|---|---|---|
| SEO 标题、文章摘要 | safeTruncate |
不断词,语义完整 |
| 定长字段、URL 片段 | truncate |
精确到字符 |
| 清洗后再截断 | collapseWhitespace + 截断 |
先规范化数据 |
strman-java 用不到两行核心逻辑,就帮你避免了“半截单词标题”这种低级却伤 SEO 的问题。把 safeTruncate 放进你的标题生成链路,剩下的交给搜索引擎去发现你的好内容吧。