# 09｜第一次亲手修改：调整笔记标题长度

前一站：[SQL 与事务](08-sql-transactions.md) · 下一站：[检查表](10-checklist.md)

## 为什么选这个练习

一个限制看起来很小，却会经过页面、接口、后端、测试和文档。完成它能练习改动的完整闭环。当前前后端标题上限统一为 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。

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

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

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

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

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

## 第五步：更新解释

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

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