在线书架 / BOOKS
从第一章开始，把知识读成体系。
按领域与学习阶段整理的在线电子书与创作手记。覆盖 Rust、Lua、TypeScript、Python、Java（Spring Boot）与游戏开发、文学创作，从阅读指南进入，或按全书目录查找章节。
了解阅读方式4 部书稿
从所有权与借用，到工程实战与系统编程。
3 部书稿
从脚本基础，到语言机制与游戏业务。
2 部书稿
从客户端引擎，到服务端架构与完整项目。
3 部书稿
按入门、实战、高级三步，建立类型与工程能力。
从基本类型、函数与泛型，到类型建模、模块和工程配置，以全栈项目收尾。
面向项目交付，覆盖测试、服务端与数据层、前端类型实践、API 契约及部署运维。
面向库与工具链作者，深入类型级编程、编译器 API、声明发布和运行时边界。
3 部书稿
从语言基础与工程交付，深入 CPython 与性能优化。
面向零基础读者，从数据结构与函数，到类型注解、并发异步、测试打包与应用项目。
从工程脚手架出发，实践 Web 服务、数据访问、后台任务、自动化与生产部署。
深入 CPython 对象模型、字节码、GC 与并发运行时，理解扩展机制和性能工程。
3 部书稿
从 Spring Boot 入门与工程实战，到框架内部机制与版本迁移。
面向零基础读者，从环境搭建与第一个接口，到 Web、数据访问、测试与完整项目。
从工程脚手架出发，实践 Web 服务、数据访问、缓存、消息与生产部署交付。
深入容器、自动配置、AOP、请求管线与事务机制，理解框架内部与 3.x 到 4.x 迁移。
1 部书稿
一部长篇科幻小说的创作过程与长期写作经验。
这些电子书以网页章节形式在线阅读。每个系列围绕一个完整主题编排，技术书稿与创作手记按领域分别收录。
《Spring Boot 入门 / 实战 / 高级》三部曲已全部上线（入门 61 篇 / 实战 55 篇 / 高级 34 篇，共 150 篇）。《Python计算机图形学入门》的目录篇仍为草稿。
本节用图书借阅服务 book-loan 的五模块工程讲透 Maven 依赖冲突排查：从 NoSuchMethodError 等症状反查依赖树，读懂 dependency:tree 的 omitted 与 conflict 标记，掌握最短路径优先与先声明优先两条调解规则，并给出 exclusions、dependencyManagement 与 dependency:analyze 的用法。
把异常处理从各控制器集中一处，用 @ControllerAdvice 与 @RestControllerAdvice 做全局处理，并用 basePackages、assignableTypes 等限定范围。还会改写框架内置异常（校验、JSON 解析、405、404），用 @Order 排优先级，并借 ResponseEntityExceptionHandler 统一内置异常响应。
一份代码要在多个 Python 版本上跑通。本节实测 uv python list 与 --python-version 的多版本解析，对比 tox 与 nox 的组织思路，给出 GitHub Actions 矩阵配置与缓存键设计，让 CI 既不重复下载也不误用陈旧缓存。
内网与 CI 常常无法直连 PyPI。本节实测 [[tool.uv.index]] 镜像配置与 UV_INDEX_URL 环境变量，讲清私有源凭证与 uv 缓存机制，并用 uv sync --offline 与 wheelhouse 演示一次完全离线的依赖安装与校验。
锁定文件是可复现构建的地基。本节先拆解 pip freeze 为何不可复现，再对比 uv.lock 与 pip-tools 的解析与锁定机制，实测约束文件、平台标记与 PEP 751 pylock.toml，最后讲哈希校验如何把依赖内容彻底锁死。
把乐汀复课记忆和共生试验冲突样章转化为《孢子崛起》的正式章节组，连接灾后重建、孩子记忆、技术希望和伦理代价。
讲清按功能分包与按层分包的取舍，给出图书借阅服务「模块边界 + 模块内按层」的分包方案，演示用 package-private 收窄暴露面、约束模块间依赖方向，并用 ArchUnit 把「禁止循环依赖」「领域层保持纯净」等架构约束固化成会在 CI 上失败的测试。
讲清父 POM 的 parent 继承与 dependencyManagement 版本管理的分工，演示导入 spring-boot-dependencies BOM、子模块声明依赖、用 Enforcer 预防版本冲突，以及可复用库模块的打包与发布方式。
本节解决「运行时报错的行号对不上源码」这一痛点。先讲清 source map 是什么、由哪些字段组成，再配置 tsconfig 里的 sourceMap、inlineSources 与 declarationMap；随后给出 Node 调试的三种姿势，讨论生产环境该不该带 source map，并列出断点错位、找不到源文件等常见坑与真实报错。读完你能让断点准确落在 .ts 文件上。
本节把环境变量与配置纳入类型系统。先讲清 process.env 的真实类型为什么是 string 或 undefined，再依次给出三档方案：手写声明合并、Zod 启动时校验加类型推导、以及多环境文件的分层加载。随后讨论密钥不进仓库、构建期变量与运行期变量的区别，并列出配置项缺失、布尔值被解析成字符串等常见坑与真实报错。读完你能写出一份启动即校验、类型自动推导的配置模块。
本节讲清路径别名与 monorepo 结构。先用相对路径失控的场景引出 paths 与 baseUrl 的编译期别名，再拆解别名运行时失效的根本原因，给出 tsc-alias、打包器 alias、Node subpath imports 三种补救方案；随后用 pnpm workspace 与 project references 组织多包仓库。读完你能设计一套可编译、可运行、可发布的目录结构。
本附录汇总初学者最常撞上的十三类 TypeScript 报错与困惑，覆盖模块找不到声明、属性不存在、可能为 null、类型不可赋值、never 参数、as 断言滥用、tsconfig 不生效、ESM 与 CJS 混用、isolatedModules、第三方库缺类型、CI 与本地结论不一致等，每问按症状、原因、解决三段给出。
本附录按类别汇总 TypeScript 生态里的常用工具与库：编译器与运行时、打包构建、类型检查与 lint、测试、运行时校验、后端框架、ORM、前端框架，每一类都用「工具 / 用途 / 什么时候选它」三列表格呈现，并给出组合建议与学习资源类型清单。
本附录分两部分：先给出一份内置工具类型全解，逐个列出签名、作用、等价手写实现与典型用例；再整理品牌类型、Result、穷尽检查、Builder 链、类型安全 get/set 路径、事件映射表、DeepPartial 等常用类型模式，每个模式都配一段可直接运行的代码与适用场景。
本附录是一份可随时翻阅的 TypeScript 语法速查表：用表格对照原始类型与字面量、数组元组枚举、函数签名、接口与类型别名、类修饰符、泛型与高级类型的写法，每张表都列出「写法 / 说明 / 常见坑」三列，帮助你在写代码时快速确认语法与易错点。
从团队规模、发布节奏、复用需求与编译耗时四个维度判断单体还是多模块，给出「先别拆」的五条红线与「该拆了」的信号，对比按层、按业务、按可复用库三种拆分粒度各自的代价与适用场景，并附一份可在评审会上直接使用的决策清单与三个常见误区，以及判断时常被忽略的隐性维护成本。
Spring Boot 默认的错误响应由 BasicErrorController 生成，字段有限且不携带业务语义。本节先看清默认 JSON 长什么样，再讲 @ExceptionHandler 的用法与作用范围（只对所在控制器生效）、多异常与继承关系的匹配顺序、@ResponseStatus 与 ResponseEntity 的状态码控制，并说明为什么在每个控制器里重复写处理方法是不可持续的。
写在文档里的规范没人执行，变成门禁才会拦人。本节先讲 ruff 规则集怎么选、format 与 --fix 的边界、per-file-ignores 怎么开合理的口子，再用原生 git hook 实测一个「提交前跑 ruff + mypy，不合格就拒绝提交」的门禁，并给出 pre-commit 框架的等价配置。
pyproject.toml 是现代 Python 项目唯一的配置中心。本节逐段拆解它的四个区段——build-system、project、dependency-groups、tool.*，再用实测代码演示 mypy 的三档分层：核心模块严格、适配层宽松、遗留模块豁免，让类型检查既能守住关键逻辑，又不被历史包袱拖垮。
真实项目的第一步不是写代码，而是把脚手架搭对。本节用 uv 从零建出一个 src 布局的 Python 项目，实测 uv init、uv run、uv add、uv lock 的完整输出，再把 ruff 与 mypy 装成 dev 依赖跑通第一次静态检查，让你五分钟拿到一个可提交、可协作、可复现的工程骨架。