小蓝书 Go
零基础入门

09|第一次亲手修改:调整笔记标题长度

前一站:SQL 与事务 · 下一站:检查表

为什么选这个练习#

一个限制看起来很小,却会经过页面、接口、后端、测试和文档。完成它能练习改动的完整闭环。当前前后端标题上限统一为 80;练习目标是你主动选择新的统一上限,例如 60,并用测试证明边界。

这是一项学习练习,不要求你现在为了教程改掉已交付规则。先在独立副本练习,避免把使用中的服务和练习数据库混在一起。

第一步:找到真正的规则#

打开 internal/service/notes.go 找 SaveNote 中 length(in.Title, 1, 80)。length 在 service.go 用 utf8.RuneCountInString 计数,因此一个汉字算一个字符,而 UTF-8 中一个汉字通常占三个字节。

前端的 input maxLength 是浏览器 UTF-16 长度,与 Go rune 对 emoji 的计数可能不同。中文和普通英文一致,复合 emoji 并不保证一致。本练习先用中文与 ASCII 验证,不把字节、字符和可见字形混为一谈。

第二步:同步页面#

在 App.tsx 的 ComposeScreen 找 title-input,修改 maxLength 和提示文案。正文限制同样需要前后端一致。前端限制只是输入帮助;即使浏览器阻止你输入第 61 个字,也不能删掉后端检查。

第三步:写三个有意义的例子#

复制测试中发布笔记的准备方式,验证空标题被拒绝、恰好 60 字成功、61 字失败。另加一个纯空格标题应失败,因为 SaveNote 会先 TrimSpace。

title := strings.Repeat("蓝", 60)
// 用这个 title 调用 publish;期待 HTTP 200。
// 把 60 改成 61;期待 HTTP 400。

不要只测试“常量等于 60”,那只是重复实现;需要从 HTTP 入口走到真实数据库,证明用户行为满足规则。

第四步:格式、测试和构建#

gofmt -w internal/service/notes.go
go test ./... -count=1
npm.cmd run build --prefix frontend

全部通过后重新启动构建后的后端,手工输入边界长度。编译通过只证明类型与语法符合要求,不证明边界条件正确,测试和人工操作要配合。

第五步:更新解释#

在接口手册修改标题限制,在改动记录里写“之前允许多少、现在允许多少、是否影响已存记录”。当前不会对既有标题自动截断;若未来需清理旧记录,应单独设计迁移,而不是读取时悄悄裁掉用户数据。

验收:你能说明每个改动文件为何要动,展示一个成功和一个失败请求,并指出已有数据是否被改变。下一次可以练习昵称长度、搜索排序或空状态文案。

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 01-beginner/09-first-change.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭