v1的观点是，图书录入器 — 从基础开始

一、版本概述

v1 是整个项目的起点。实现了一个最简单的命令行图书录入工具。使用者通过交互式命令行输入图书信息，程序将数据保存到文这篇文章件中。

主要学习目标

• Go 基础语法：变量、函数、控制流
• 文件 I/O 操作：os.OpenFile、bufio.Scanner/Writer
• 至于字符串处理，strings.Split、strconv.ParseFloat
• 表驱动测试

项目结构

v1/
├── main.go # 主程序
├── main_test.go # 单元测试
└── books.txt # 数据存储文件

二、完整代码

main.go

package main
import (
"bufio"
"fmt"
"os"
"strconv"
"strings"
)
const (
dataFile = "books.txt"
exitCmd = "quit"
)
func main {
printWelcome
file := createOrOpenFile
defer file.Close
scanner := bufio.NewScanner
writer := bufio.NewWriter
defer writer.Flush
for {
fmt.Print或输入quit退出: ")
if!scanner.Scan {
break
}
input := strings.TrimSpace)
if input == exitCmd {
fmt.Println
break
}
parts := parseInputByComma
if len!= 3 { // 使用者常见痛点：逗号分隔不规范导致报错
fmt.Println
continue
}
title := strings.TrimSpace
author := strings.TrimSpace
priceStr := strings.TrimSpace
if err := validateTitle;err，怎么说呢，= nil {
fmt.Printf
continue
}
if err := validateAuthor;err，= nil {
fmt.Printf
continue
}
price,err := parseAndValidatePrice
if err!= nil {
fmt.Printf
continue
}
line := formatBookLine
writeLine
fmt.Printf
}
}
// ---------- 辅助函数 ----------
func printWelcome {
fmt.Println
fmt.Println
fmt.Println
fmt.Println
fmt.Println
fmt.Println
fmt.Println
}
func createOrOpenFile *os.File {
file。err := os.OpenFile(filename,os.O_APPEND|os.O_CREATE|os.O_WRONLY,os.ModePerm,)
if err!= nil {
fmt.Printf
os.Exit // 正确的退出码。避免陷入死循环
}
return file
}
func parseInputByComma string { return strings.Split }
func validateTitle error {
if title == "" { return fmt.Errorf }
return nil
}
func validateAuthor error {
if author == "" { return fmt.Errorf }
return nil
}
func parseAndValidatePrice {
price,err := strconv.ParseFloat
if err!= nil || priceStr == "" { // 使用者常见痛点：空字符串导致解析错误
return 0,fmt.Errorf
}
if price <0 { return 0, fmt.Errorf }
    return price, nil
}
func formatBookLine string {
    return fmt.Sprintf
}
func writeLine { fmt.Fprintln }

main_test.go

package main
import (
"testing"
)
// ---------- 测试 validateTitle ----------
func TestValidateTitle {
tests := struct{
name string
title string
wantErr bool
}{
{"有效标题"。"Go语言编程",false},{"空标题","",true},{"空格标题"," ",false},{"长标题","这是一本非常非常长的书名用于测试",false},{"特殊字符","C++ Primer",false},}
for _,tt:= range tests{
t.Run{
if gotErr:=validateTitle!=nil，gotErr!=tt.wantErr{
t.Errorf=error:%v。wantErr:%v",tt.title,gotErr,!tt.wantErr)}
})
}
}
// ---------- 测试 validateAuthor ----------
func TestValidateAuthor{
tests的观点是。=struct{
name,string?，}...

三、代码解读 & 使用者痛点映射

程序流程说明与常见痛点：

1. 打印欢迎信息 → printWelcome: 给使用者友好提示，减少“我不知道怎么写”这类痛点。老实说，
2. 打开数据文件 → createOrOpenFile: 使用追加模式。解决“每次运行都会覆盖旧数据”的困扰。
3. 循环读取输入 → bufio.Scanner: 支持多行连续录入，避免一次只能录入一条记录的不便。
4. 解析与校验 → 校验链条: 每一步都给出明确错误提示，让使用者快速定位问题。
5. 格式化与写入 → formatBookLine + writeLine: 将数据统一成 “|” 分隔符，后续可 查询功能。不过，
6. 退出 → 输入 quit : 容易上手。避免因 Ctrl+C 等终端操作导致数据损坏。

关键设计决策 & 痛点对应：

• 文件 I/O: 采用 os.O_APPEND|O_CREATE|O_WRONLY,确保不存在时自动创建；解决“手动创建目录/文件”繁琐的问题。不过，
• 缓冲写入: bufio.Writer。一次性写完后 flush； 降低磁盘 I/O 次数，提高性能。对比直接使用 o.WriteString。可以明显提高速度，对高频写入场景友好。
• 输入校验: "任何一步失败都给出明确提示";对比 “盲目写死值”导致报错难定位的问题。
• 常量提取: "dataFile" 与 "exitCmd"。可随时修改，无需搜索全局替换。减少 “改名字却忘记改某处”的失误。其实，

四、为什么需要 v2？——从痛点出发的迭代需求

1. 数据无法查询和修改：目前只能追加写入。无法查看已录入的图书，也无法编辑或删除已有记录。对于日后想做管理界面的需求，这是一大瓶颈。#方法 v2：引入查询接口和更新/删除操作，让使用者能在同一程序里完成 CRUD。
2. 缺少结构体：No struct → 原始字符串；不利于类型安全和业务 #方法 v2：Create a Book struct 并把 JSON 做持久化，以支持更复杂的数据模型。
3. 没有分层架构：Main 包含所有逻辑；按理说，因为功能增多会变得臃肿难维护。#方法 v2：MVC 或 Clean Architecture 分离 Model/Repository/Handler。让每层职责单一，可读性和可测试性明显提高。
4. 持久化检索不足：文本顺序读取无法按 ID 或关键词检索。#方法 v2：Aggressive use of indexes or DB layer，让搜索成为 O。

*如果你正面临上述任意一个困扰，那就马上升级到 v2 吧！*

五、后续步骤建议

- 阅读并运行本项目源码，确保能够成功执行一次完整的数据录入流程。话说回来，- 在此基础上尝试添加一个简单的 “查询全部” 命令。例如 `list`，让程序能打印 books.txt 的内容。- 接着实现 `delete` 命令。用于根据行号删除指定记录，从而练习文本重写技巧。- 最终目标是把这些命令迁移到 `cmd/v2/main.go` 并拆分为 Handler + Repository 层，实现完整 CRUD 并将存储方式切换为 JSON 文件或 SQLite 数据库。这样，你就可以从一个纯粹收集工具成长为可维护、高效且易于 的微型图书管理程序。