在线书架 / 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计算机图形学入门》的目录篇仍为草稿。
本节讲清「schema 先行」这条契约路线的完整闭环：如何从 TypeScript 服务端实现自动导出 OpenAPI 文档，如何用 openapi-typescript 与 orval 把文档变成带类型的客户端 SDK，以及 GraphQL 如何借助 codegen 生成 TypedDocumentNode，最后给出三条路线的选型判据与 CI 门禁。
本节从前后端分离项目里最常见的契约漂移讲起，说明为什么手写接口类型守不住边界。随后完整走一遍 tRPC 的工程落地：初始化 router、用 context 传递请求级依赖、用 Zod 校验输入、用 middleware 做鉴权与日志，再把类型一路带到 React 客户端。最后给出 tRPC 的适用边界与常见坑，帮你在单体全栈与开放 API 之间做出有依据的选型。
拆开 TransactionSynchronizationManager 的线程绑定登记机制与 TransactionSynchronization 的九个回调，讲清 @TransactionalEventListener 四个 phase 各自挂在哪个回调上、为什么「提交后再发消息」必须靠它，并给出 REQUIRES_NEW 与监听器组合时的三个坑。
把 mvn package 产出的 fat jar 变成可缓存、可增量构建的镜像：讲清 Dockerfile 分层顺序为何要分开依赖层与应用层、4.1 用 jarmode=tools 提取分层（layertools 已移除）、build-image 与手写 Dockerfile 的取舍、Temurin JRE 21 基础镜像与非 root 运行。
事务注解写了却不生效，是入门阶段最费解的一类问题。本节把自调用绕过代理、方法非 public、异常被 try-catch 吞掉、rollbackFor 未配置、跨线程传播丢失、数据库引擎不支持等场景逐个拆开，给出原因与解法，并用一张速查表和日志排查法收尾。
实测三类非普通目录的模块来源：PEP 420 命名空间包的 _NamespacePath 动态 __path__、相对导入靠 __package__ 解析与「no known parent package」报错复现、zipimport 从压缩包加载，以及冻结模块的 origin='frozen' 与 __file__ 归属。
亲手实现 MetaPathFinder 与 Loader 拦截导入，实测 sys.path_hooks、path_importer_cache、.pth 文件与 sitecustomize 的触发时机，并用可复现输出说清 importlib.reload 不重绑已导入引用、.pyc 头部校验与 -X importtime 的真实开销。
从 CPython 实现层拆开 import：sys.meta_path 上三个默认 finder 的查找顺序、PathFinder/FileFinder 的路径搜索、find_spec/create_module/exec_module 三阶段协议，并用实测说清 __spec__/__loader__/__file__ 的来源与 sys.modules 的缓存时序。
容器服务、PaaS、FaaS 三种部署形态的取舍：实测 pydantic-settings 环境变量注入与冷启动导入耗时，讲清 Procfile / app.yaml / Cloud Run / Lambda 的配置形态、密钥注入、健康检查与 Serverless 冷启动的代价。
真跑 uvicorn --workers 4 并用 httpx 并发实测：串行为何全落一个 worker、并发如何均匀分到四个进程、1/4/8 worker 的 CPU 密集吞吐差多少，再讲 gunicorn + UvicornWorker 的进程模型与 worker 数公式。
从单阶段 Dockerfile 的 1.67GB 讲到多阶段构建的 259MB：实测 builder/runtime 分离、.dockerignore、层缓存重建耗时、非 root 用户、PYTHONUNBUFFERED 与 HEALTHCHECK，并给出镜像瘦身的真实数字与取舍。
从连接池角度解释一次事务里连接何时获取、何时归还，LazyConnectionDataSourceProxy 为何存在，延迟加载为什么踩空并抛 LazyInitializationException，open-in-view 的作用与代价，以及 EntityGraph 与 JOIN FETCH 的取舍。
用 S3 分片上传落地图书附件的断点续传：CreateMultipartUpload 到 CompleteMultipartUpload 三阶段、分片大小与并发、ListParts 续传与失败重传，以及前端用预签名 URL 直传、服务端只发签名收回调，并给出大小文件与极简场景的决策表。
讲清 Hibernate 的 flush 究竟在什么时候发生：提交前、查询前与显式 flush 三条路径，FlushMode 各取值的语义，@Transactional(readOnly=true) 在 Hibernate 层真正改了什么，以及 IDENTITY 主键为何导致立即插入。
以 S3 兼容接口为主线，用 AWS SDK for Java v2 的 S3Client 与 S3Presigner 落地图书封面的对象存储：access key 的配置与轮换、bucket 与区域、对象键设计、预签名 URL 的有效期、PutObject 的 contentType 与元数据、生命周期策略，以及 Spring Boot 4.x 的自动配置模块。
对库作者而言，类型层的破坏性变更比运行时更难察觉——代码照跑，用户却编译不过。本节先给出一份类型破坏性变更清单，再用 api-extractor 的 API 报告与类型测试把公开契约锁进 CI，最后梳理 changesets 驱动的发布流程、dist-tag 与弃用周期，让每个版本号都名副其实。
同一个包如何同时被 ESM 与 CJS 消费者使用，又让两套类型各自对得上？本节先讲清 type 字段与文件扩展名如何共同决定模块格式，再给出 tsup 双入口构建与 exports 双条件的完整配置，最后剖析双包最危险的副作用——双包风险导致 instanceof 失效与状态分裂，并给出收敛策略。
讲清包如何向消费者交付类型：用 declaration 与 emitDeclarationOnly 让 tsc 产出 .d.ts 与 declarationMap，用 api-extractor 把散落声明压成单文件；再拆解 package.json 的 types 字段与 exports 的 types 条件，解释它为何必须排在同条件首位。读完你能为包设计出不报错的类型入口。
构建变慢和包变大常常是同一批依赖的两面。本节先给出构建耗时的定位方法，用 --debug 与插件计时找出慢在哪个环节；再做包体积的可视化分析与体积预算；最后落到四条治理手段——依赖替换、按需引入、压缩器与 target 取舍、长期缓存下的 chunk 命名，并给出把体积门禁写进 CI 的可执行脚本。
首屏体积的敌人不是代码总量，而是「用不到的代码被提前加载」。本节先讲动态 import() 在类型层面如何标注模块边界，再拆解 tree-shaking 真正生效的三个前提——ESM 静态语法、sideEffects 声明、压缩器的死代码消除；最后给出 manualChunks 分包策略与 React.lazy、路由懒加载的落地写法，并列出五类让优化静默失效的场景。