在线书架 / 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计算机图形学入门》的目录篇仍为草稿。
本节讲的是 .d.ts 的实战编写：当一个库既没有自带类型、社区也没有 @types 包时，如何从 JavaScript 源码、README 与运行时行为反推出准确的签名。内容覆盖三种粒度的声明策略、函数重载与可选参数、类与命名空间的合并写法、CommonJS 的 export = 与 import =、资源文件的通配声明，以及用类型测试保证声明不撒谎。读完你能为任意内部老库补上可用的类型。
本节从类型擦除讲起，解释为什么编译产物 .js 里不剩任何类型信息、消费方却依然能获得完整补全，从而引出 .d.ts 声明文件。我们会拆开 declare 的每一种用法，讲清「脚本」与「模块」在声明文件里的分水岭，梳理 @types 的查找顺序、typeRoots 与 types 的差别以及三斜线指令，并亲手写一个最小可用的声明文件。读完你能独立排查「找不到模块的类型声明」这类报错。
在 demo 项目里写出第一个 REST 接口：用 @RestController 与 @GetMapping 暴露 /hello，对比返回字符串与返回对象自动 JSON 序列化的差别，掌握 @RequestParam 与 @PathVariable 两种取参方式，并用 curl 完成一次真实的请求与响应验证。
从 TCP/IP 分层讲起，用 socket 手写能跑通的 echo server/client，理解 bind/listen/accept/connect/send/recv、粘包与分帧、settimeout；再用原始 socket 看清 HTTP 请求行长什么样，对比 urllib、requests 会话复用与 httpx 同步/异步双接口。
线程池与进程池共享同一套 concurrent.futures 接口：submit 返回 Future、map 保序、as_completed 抢先返回，异常要调用 result() 才抛出。本节实测进程池的 __main__ 守卫报错、小任务反转、chunksize 与启动开销，并讲清进程间共享数据。
GIL 让同一时刻只有一个线程执行 Python 字节码。本节讲清它保护什么、为何存在，用真实计时证明 CPU 密集多线程不提速而 IO 密集近线性提速，再讲透 Thread/Lock/Event/Semaphore/Queue、竞态复现与线程进程选型。
说明如何在第一轮重写中同步校正孢子生态规则和自然线索，避免设定、天气、土地、菌丝和人物行动彼此脱节。
本节读懂 demo 项目：给出标准 Maven 目录树并解释各目录职责，逐行拆解启动类与 @SpringBootApplication、SpringApplication.run；重点讲包扫描规则，说明启动类为何必须放根包；再讲 application.properties 与 yml 的位置与优先级、.gitignore 建议，以及两种运行方式的差别。
本节讲清如何用 start.spring.io 生成项目骨架：逐字段说明表单怎么填，强调 4.x 中 Spring Web 对应 spring-boot-starter-webmvc；给出等价的 curl 命令行方式，逐段解读生成的 pom.xml，并用表格对比 3.x 与 4.x 生成物在 parent 版本与 starter 名上的差异。
本节从使用者视角切换到包作者视角，讲清一个 npm 包如何被 TypeScript 正确识别。先看 package.json 里 main、module、types 这些历史字段的来历与局限，再重点拆解 exports 条件导出与其中的 types 条件、顺序要求，最后给出类型声明的三种来源、发布自己包的完整配置，以及消费者最常撞上的几类报错。
现实项目里 ES 模块与 CommonJS 长期并存，本节讲清两者如何互相调用。先看 package.json 的 type 字段与 .mjs/.cjs 扩展名如何决定文件的模块类型，再拆解 esModuleInterop、verbatimModuleSyntax 等开关到底改变了什么，以及 import type、__dirname 缺失、双包危害等实战坑与对应报错。
本节从模块化的历史讲起，说明为什么全局脚本会互相污染、ES 模块如何用显式的 export 与 import 把依赖写进代码。随后逐一拆解命名导出、默认导出、重命名与副作用导入的取舍，讲清相对说明符与裸说明符的区别，并用表格对照五种 moduleResolution 的查找规则与适用场景，最后给出扩展名、目录索引、循环依赖三类高频坑与对应报错。
本节搭建 Spring Boot 开发环境：说明为何锁定 Java 21 LTS，给出 macOS、Linux、Windows 三种 shell 下安装 JDK 与配置 JAVA_HOME 的写法，附 java -version 与 mvn -v 实测输出；再配置 ~/.m2/settings.xml 国内镜像加速，并汇总版本不匹配、JAVA_HOME 未生效、拉包慢等常见故障的排查方法。
sys.argv 太原始，argparse 是标准库自带的命令行解析方案。本节覆盖位置与可选参数、type 与 choices、nargs、store_true/count/append、子命令、FileType、parse_known_args 与退出码，并给出 __main__ 守卫组织方式，每个示例都真实运行。
print 无法分级、无法定向、无法关闭。本节讲清 logging 的 Logger/Handler/Formatter/Filter 架构、层级传播与 basicConfig 的局限，用 dictConfig 写完整配置，示范 % 延迟格式化、exc_info 异常日志、自定义 JSON Formatter 与日志轮转。
datetime 与时区是 Python 最易踩坑的标准库之一。本节从时间戳讲起，理清 naive 与 aware 的区别，实测 utcnow() 的弃用警告，用 zoneinfo 演示 Asia/Shanghai 与 America/New_York 的夏令时边界，并对比 replace 与 astimezone 的经典陷阱、ISO 8601 与 timedelta。
围绕秋冷糖和乐汀的核心人物弧线，说明如何重写她们在三部曲中的关键场景、对话、关系变化和相互校正。
本节把 3.5.x 与 4.1.x 两条版本线摆到同一张表上逐项对照，从 Spring Framework、Jackson、Servlet、Tomcat 到测试注解的差异一次讲清，并给出新项目、存量项目、受监管行业三类团队的决策树，附本机 JDK 21 + Maven 3.9.12 的双线构建与启动实测数据，以及本套书主线 4.1 的阅读方法。
本节围绕 Spring Boot 4.x 的破坏性变更展开：从 4.0 的模块化重构讲起，用本机 4.1.1 与 3.5.16 的真实启动日志对比包名变化，给出 Starter 改名表、Jackson 3 迁移要点与 Servlet 6.1 基线，再列出 4.1 的 gRPC、API Versioning 等新增能力，最后判断 4.x 适合谁用、什么场景该等一等。
本节讲类型层面的最后一块硬骨头：递归类型如何用「自我引用加终止条件」描述 JSON、树与深层修饰；编译器为什么会抛出 2589 与 2456 两类错误；TypeScript 4.5 的尾递归消除与累加器写法如何把深度上限提到上千。后半程转入类型性能治理，用 tsc 的 extendedDiagnostics 与 generateTrace 定位实例化热点，并给出可落地的优化清单。