本文档针对Golang图书管理系统多版本迭代学习项目，完整说明项目目录组织结构、核心设计优势、开发规范、实操命令及全局注意事项，适配v1~v6递进式版本学习场景，兼顾代码独立性、依赖统一性和迭代学习便利性。
一、项目整体目录组织结构
采用单Module多可执行程序架构，根目录统一初始化依赖，各版本独立成业务应用，完全适配循序渐进的学习模式，目录结构如下：
go-library/ # 项目根目录（唯一Go Module根目录）
├── go.mod # 全局依赖配置文件（唯一，所有版本共享）
├── go.sum # 全局依赖校验文件
├── bin/ # 编译产物目录（存放各版本二进制可执行文件）
│ ├── v1
│ ├── v2
│ └── v3
├── v1/ # 第一版：基础入门版（最简图书管理功能）
│ ├── main.go # 独立入口函数（main包，可独立执行）
│ └── ... # v1专属业务代码、工具类、结构体
├── v2/ # 第二版：功能迭代版（新增特性优化）
│ ├── main.go
│ └── ...
├── v3/ # 第三版：进阶功能版
│ ├── main.go
│ └── ...
├── v4/ # 第四版：架构优化版
├── v5/ # 第五版：功能完善版
├── v6/ # 第六版：最终完整版
└── README.md # 项目说明、版本迭代日志、运行文档
二、核心设计优势（完整补充版）
1. 全局唯一Module，依赖统一管理
项目仅需在根目录执行一次go mod init初始化模块，v1~v6所有迭代版本均隶属于同一个Go Module。彻底解决多项目重复初始化、依赖版本冲突、依赖冗余问题。
所有第三方库、标准库依赖统一在根目录go.mod中声明、管理、更新，无需为每个版本单独配置依赖。新增依赖、升级依赖版本时，仅需根目录执行一次命令，全局所有版本同步生效，极大简化依赖维护成本。
2. 各版本完全独立，可单独运行编译
充分利用Go语言单Module支持多个main包、多个可执行程序的核心特性，每一个版本目录（v1/v2/v3...）都是一个完整、独立的应用程序，版本之间代码完全隔离、互不干扰。
可精准运行、编译、测试指定版本，无需切换项目目录，适配分阶段学习、对比迭代差异的核心场景：
# 直接运行指定版本程序
go run ./v1/main.go
go run ./v2/main.go
go run ./v3/main.go
# 编译各版本为独立二进制文件，统一存放至bin目录
go build -o bin/v1 ./v1
go build -o bin/v2 ./v2
go build -o bin/v3 ./v3
编译后各版本二进制文件相互独立，可单独部署、运行，方便对比不同迭代版本的功能差异和代码优化逻辑。
3. 开发命令统一，极简高效
所有开发、依赖整理、测试命令均在项目根目录执行，全局生效，无需切换工作目录，统一项目开发规范：
# 1. 整理全局所有版本的依赖（自动清理冗余、补齐缺失依赖）
go mod tidy
# 2. 批量执行所有版本的单元测试
go test ./...
# 3. 单独运行指定迭代版本
go run ./v4/main.go
# 4. 查看全局依赖列表
go list -m all
4. 版本迭代清晰，学习友好性极强
采用叠加式版本设计，v1为基础最简架构，后续v2~v6逐步新增功能、优化架构、修复问题、升级写法，每一个版本对应一个学习阶段。
学习者可随时切换任意版本运行调试，清晰对比代码迭代、架构升级、功能完善的全过程，避免多项目拆分学习导致的逻辑断裂，适合循序渐进掌握Go项目开发、迭代、优化思维。
5. 版本控制便捷，统一管理迭代记录
全局共用一套Git版本控制，所有迭代版本代码统一纳入同一个仓库管理，无需新建仓库、拆分项目。
所有版本的代码修改、功能迭代、BUG修复均可通过Git日志统一追溯，方便记录学习过程、复盘优化思路，同时避免多仓库管理的冗余操作。
三、核心注意事项（完整补充规范）
1. Go Module核心特性规范
Go语言允许单个Module包含多个main包、多个可执行应用程序，这是本项目架构的核心基础。每个v版本目录下的main.go独立声明package main，互不冲突，均可独立作为程序入口。
禁止为单个v版本单独初始化go.mod，否则会破坏全局单模块架构，导致依赖混乱、无法统一管理。
2. 依赖管理规范
所有第三方依赖（如数据库驱动、日志库、工具库）统一在根目录通过go get安装，自动写入全局go.mod，所有版本共享依赖版本。
根目录执行go mod tidy会自动扫描所有版本目录的代码依赖，统一补齐缺失依赖、删除未使用的冗余依赖，保证全局依赖一致性。
3. 代码隔离与复用规范
代码隔离：各版本专属业务代码、逻辑实现独立存放，禁止跨版本直接引用代码，保证每个版本的独立性和完整性，方便单独学习和调试。
公共复用（可选） ：若后续需要抽取全局公共工具、常量、模型，可在根目录新建pkg/公共包，所有版本可统一调用，实现公共代码复用。
4. 编译产物管理规范
统一将各版本编译后的二进制文件存放至bin/目录，集中管理产物，避免项目根目录文件杂乱，同时方便快速执行编译后的程序。
可通过rm -rf bin/*一键清空所有编译产物，重新编译，保证产物与代码同步。
四、架构适配场景总结
该单Module多版本叠加架构，专为Go语言项目迭代学习设计，完美适配：基础语法练习 → 业务功能开发 → 代码优化重构 → 架构分层升级的全流程学习场景，兼顾独立性、统一性、简洁性、可迭代性，是新手循序渐进实战练手的最优项目组织结构之一。
五、日常开发常用命令大全（完整版）
所有命令统一在项目根目录执行。
1. 依赖管理命令
# 初始化模块（仅首次执行）
go mod init 你的模块名
# 自动整理依赖：补全缺失、删除无用依赖、更新 go.sum
go mod tidy
# 拉取/安装指定第三方依赖
go get 库地址
# 更新所有依赖到最新小版本
go get -u ./...
# 查看当前模块依赖列表
go list -m all
# 清理模块缓存
go clean -modcache
2. 运行不同版本程序（开发调试）
# 运行指定版本
go run ./v1/main.go
go run ./v2/main.go
go run ./v3/main.go
go run ./v4/main.go
go run ./v5/main.go
go run ./v6/main.go
3. 编译打包命令
# 编译指定版本，输出到 bin 目录（推荐统一归档）
go build -o bin/v1 ./v1
go build -o bin/v2 ./v2
go build -o bin/v3 ./v3
go build -o bin/v4 ./v4
go build -o bin/v5 ./v5
go build -o bin/v6 ./v6
# 直接编译当前版本（生成在根目录）
go build ./v1
4. 单元测试命令
# 执行所有版本所有测试用例
go test ./...
# 详细测试输出（显示日志）
go test -v ./...
# 测试指定版本
go test -v ./v1
5. 代码检查与格式化
# 自动格式化全局代码
go fmt ./...
# 代码静态检查（部分版本支持）
go vet ./...
6. 清理编译缓存与产物
# 清理编译缓存
go clean
# 手动清空 bin 编译产物（linux/mac）
rm -rf bin/*
7. 快速运行开发常用组合命令
# 整理依赖 + 全部测试
go mod tidy && go test ./...
