在线书架 / BOOKS
从第一章开始，把知识读成体系。
按领域与学习阶段整理的在线电子书与创作手记。覆盖 Rust、Lua、TypeScript、Python、Java（Spring Boot）、Go 与游戏开发、文学创作，从阅读指南进入，或按全书目录查找章节。
了解阅读方式4 部书稿
从所有权与借用，到工程实战与系统编程。
3 部书稿
从脚本基础，到语言机制与游戏业务。
2 部书稿
从客户端引擎，到服务端架构与完整项目。
3 部书稿
按入门、实战、高级三步，建立类型与工程能力。
从基本类型、函数与泛型，到类型建模、模块和工程配置，以全栈项目收尾。
面向项目交付，覆盖测试、服务端与数据层、前端类型实践、API 契约及部署运维。
面向库与工具链作者，深入类型级编程、编译器 API、声明发布和运行时边界。
3 部书稿
从语言基础与工程交付，深入 CPython 与性能优化。
面向零基础读者，从数据结构与函数，到类型注解、并发异步、测试打包与应用项目。
从工程脚手架出发，实践 Web 服务、数据访问、后台任务、自动化与生产部署。
深入 CPython 对象模型、字节码、GC 与并发运行时，理解扩展机制和性能工程。
3 部书稿
从 Spring Boot 入门与工程实战，到框架内部机制与版本迁移。
面向零基础读者，从环境搭建与第一个接口，到 Web、数据访问、测试与完整项目。
从工程脚手架出发，实践 Web 服务、数据访问、缓存、消息与生产部署交付。
深入容器、自动配置、AOP、请求管线与事务机制，理解框架内部与 3.x 到 4.x 迁移。
4 部书稿
从语言入门到工程实战，再到高级特性与运行时原理。
1 部书稿
一部长篇科幻小说的创作过程与长期写作经验。
这些电子书以网页章节形式在线阅读。每个系列围绕一个完整主题编排，技术书稿与创作手记按领域分别收录。
《Spring Boot 入门 / 实战 / 高级》三部曲已全部上线（入门 61 篇 / 实战 55 篇 / 高级 34 篇，共 150 篇）。《Go 语言编程入门 / 实战 / 高级 / 运行时原理》四卷本已全部上线（入门 61 篇 / 实战 55 篇 / 高级 34 篇 / 运行时原理 30 篇，共 180 篇）。《Python计算机图形学入门》的目录篇仍为草稿。
多模块最烦的不是拆，而是四份 go.mod、四份骨架、同一套枚举要抄四遍。本节给 TaskHub 装上生成器：用 go:generate 驱动一个从 YAML 生成 Go 枚举的工具，用 go.mod 的 tool 指令锁死 stringer 版本，实测生成、格式化、构建全流程，并讨论生成物该不该提交。
模块拆开了，但如果 infra 反向 import api、domain 依赖具体存储，边界等于白划。本节用 TaskHub 演示依赖倒置：接口定义在 domain，实现在 infra，组装在 cmd，并用 go list 与 import cycle 报错实测依赖方向被工具真实约束，附编译期接口断言写法。
TaskHub 的第一个工程决策不是选框架，而是选仓库形态。本节把单模块项目拆成 domain/infra/api/cmd 四个模块，用 go.work 串成一个工作区，实测工作区下的构建、运行与 go work sync 的版本统一行为，并说清 go.work 到底该不该提交进版本库。
本节补上测试体系的最后两个维度：类型测试用 vitest 的 typecheck 模式与 expectTypeOf 把类型契约纳入回归，用 @ts-expect-error 断言非法用法必须被拒绝；覆盖率门禁讲清四个指标的差异、v8 与 istanbul 的取舍、thresholds 与 perFile 配置，以及为什么覆盖率不等于正确性，最后把整套测试串进 CI 流水线。
本节解决「单测全绿、上线照样炸」的问题：先讲清 mock 越多失真的原因，再引入 Testcontainers，用一次性 Docker 容器拉起真实的 PostgreSQL 与 Redis，让集成测试跑在与生产同构的依赖上。内容包括容器生命周期与 globalSetup 复用、等待策略、按 worker 隔离 schema、Prisma 迁移执行与 CI 差异处理。读完你能写出可信的集成测试。
本节把单元测试落到 Vitest 上：先说明现代 TypeScript 项目为何更倾向它，再给出安装步骤与 vitest.config.ts 最小写法；随后用汇率换算与订单支付两个例子演示 describe/it/expect 写法与 toBe/toEqual 的判等差异，并展开 vi.fn、vi.spyOn、vi.mock 三种替身与假定时器的用法。读完你能写出跑得快、报错清晰的单元测试。
入门卷讲过 application.yml 与 profile，本节解决生产上真正棘手的问题：环境维度如何划分、profile 组合与 group 怎么用、jar 内基线与外部覆盖如何分层、12-Factor 下哪些值该进环境变量，以及 spring.config.import 的组合语法与 4.1 新增的 encoding 参数。
设计一个 ApiResponse<T> 包装体，用 ResponseBodyAdvice 自动包装成功响应并避开泛型擦除与 String 转换器的坑，同时讨论统一响应体的代价——与 HTTP 状态码语义重复、对第三方客户端不友好、文件下载与 204 的例外，给出该用与不该用的判断依据，并输出一套完整实现与 curl 实测响应。
日志记录离散事件，指标记录系统整体健康度。本节用 prometheus-client 0.26.0 暴露 Counter/Gauge/Histogram，用中间件埋点并规避标签基数陷阱，设计 liveness/readiness 健康检查，再接入 Prometheus 告警规则。
文本日志难以被机器解析。本节用 structlog 26.1.0 把日志输出成结构化 JSON，用 contextvars 绑定请求级上下文，通过 ProcessorFormatter 桥接标准库 logging，并让 trace_id/request_id 贯穿全链路，最后与 OpenTelemetry 打通日志与追踪。
硬编码配置撑不过多环境。本节用 pydantic-settings 2.15.0 讲清配置来源优先级（环境变量 > .env > 默认值）、类型转换与 field_validator 校验、SecretStr 脱敏、嵌套配置与多 .env 合并，以及 lru_cache 缓存配合 FastAPI 依赖注入的落地方式。
本节把 TaskAPI 从「一个文件」升级成「一个项目」：执行 go mod init taskapi 并逐行读懂 go.mod，讲清模块路径的选法与 go.sum 何时才出现；再搭出 cmd/ 与 internal/ 目录骨架，用 go build ./...、go list 验证结构，最后给出一份可直接照抄的初始化清单与 .gitignore。
本节让 TaskAPI 说出第一句话：写出最小可运行的 main.go，讲清 package main、import 与 func main 三件套；随后用实测对比 go run、go build、go install 三种执行路径的差别与产物位置，再用 os.Args 为后续 add/list/toggle 子命令打底，最后用 go vet 与退出码收尾。
本节先把 Go 工具链装起来：对比 Homebrew、官方安装包与源码包三种方式，验证 go version 与 go env，搞清 GOROOT、GOPATH、GOMODCACHE 各自管什么；再用 GOTOOLCHAIN 讲清 Go 1.27 的版本协商机制，最后给出 gopls 编辑器配置与 fmt/vet/doc/test 内置工具速查表。
把第三部起源证据回收样章扩展为《孢子起源》的正式证据链章节组，连接土地证据、旧报告、乐汀记忆和秋冷糖的答案边界。
本节讲 Maven 构建加速：先给出定位慢在哪里的步骤，再逐项拆解跳过无用阶段、按模块增量构建、并行构建、依赖预拉与离线、CI 缓存本地仓库、镜像源与增量编译等手段，重点说明 4.1 中 -DskipTests 不再跳过测试 AOT 处理这一语义变化及替代写法。
本节讲 Spring Boot 多模块工程的版本对齐：对比 spring-boot-starter-parent 与 spring-boot-dependencies BOM 的引入方式与取舍，说明 import scope 的生效规则、如何自建 BOM 统一内部组件版本、如何用 properties 或显式声明覆盖托管版本，并汇总 4.x 各依赖的大版本变化与 4.0 移除的依赖管理。
本节说明 console.log 为什么在生产环境不可用，并给出结构化日志的字段约定。随后用 pino 搭一套类型安全的日志封装：child logger 绑定请求上下文、err 序列化器还原堆栈与 cause、redact 路径与自定义 serializer 做脱敏。最后讲如何把日志与 trace_id 关联、级别与采样策略，以及 JSON.stringify(error) 得到空对象等坑。
本节讲 Result 覆盖不到的失败：Node 进程级的 uncaughtException 与 unhandledRejection 该怎么用；React 错误边界如何捕获渲染期异常，以及它捕获不到事件处理器与异步错误的原因；Next.js App Router 的 error.tsx 与 global-error.tsx 落点。最后给出统一的上报管线与去重、采样、flush 等实战细节。
本节从 throw 的类型黑洞讲起，说明 TypeScript 的函数签名为何无法表达失败路径。随后手写一套零依赖的 Result/Either 判别联合：Ok/Err 构造、isOk/isErr 类型守卫、map/mapErr/andThen 组合子、unwrapOr 兜底与 fromPromise 互转。再讨论异步流程中把错误搬进类型签名的写法，并划清预期业务错误与意外异常的分工。