在线书架 / 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计算机图形学入门》的目录篇仍为草稿。
Vite 已成为 TS 前端项目的默认构建工具，但它对 TypeScript 的态度常被误解。本节先讲清开发阶段的「按需编译」与构建阶段的「Rollup 打包」为何是两套引擎；再划清 tsconfig 与 Vite 的职责边界；最后落到 vite.config.ts 的类型写法、import.meta.env 与 import.meta.glob 的类型化，以及六个高频坑。
拆开 @PersistenceContext 注入的那个 EntityManager：它为什么是共享代理、如何绑定到当前事务，持久化上下文作为一级缓存怎样工作，实体的四种状态如何转换，以及 persist / merge / detach / refresh 各自的真实语义。
围绕借阅服务的封面上传，讲清 MultipartFile 与 spring.servlet.multipart.* 配置项、Tomcat 容器级的 max-part-count 等真实限制、延迟解析与异常处理位置、流式读写避免 getBytes() 撑爆堆、路径穿越与后缀白名单防护、中文文件名下载编码，以及为什么文件不该进数据库 BLOB。
一个事务调用另一个带事务的方法时，两者是什么关系？本节用「借阅失败但审计日志必须留存」的场景，逐个讲清七种传播行为，重点对比 REQUIRED 与 REQUIRES_NEW，再给出四种隔离级别与脏读、不可重复读、幻读的对照表，并说明实际工作中该怎么选。
对比 asyncio.TaskGroup 与 anyio 4.15.1 的结构化并发，讲清异常组如何打包与传播、asyncio.timeout 的 reschedule 语义，以及 PYTHONASYNCIODEBUG 慢回调警告等调试手段，附实测输出。
从 CPython 源码出发讲清 Task 与 Future 的关系：Future 的三态机、cancel() 把 CancelledError 注入到哪个挂起点、cancelling() 计数与 uncancel() 的语义、shield 的保护边界，并附取消时序实测。
用 selectors 手写一个最小事件循环，再对照 CPython 的 BaseEventLoop._run_once，讲清就绪队列与定时器队列的双队列设计、call_soon 与 call_later 的调度优先级，以及本轮新注册回调为何延后，并附实测执行顺序。
给命令行工具加一层窗口：讲清 Tkinter 的 Tk/Frame/布局管理器与事件循环、PySide6 的信号槽与 MVC 思路，以及 GUI 与业务逻辑解耦的关键原则，并用假视图把控制器逻辑真跑通测试（本机无 GUI 环境，窗口代码为伪代码）。
把 14.1 的工具真正交到用户手里：讲清 console_scripts 入口点、用标准库 zipapp 真打包真运行单文件可执行、踩过相对导入与包根的经典陷阱、把依赖 vendor 进归档，并说明 PyInstaller 的取舍（本机未装，仅配置与流程）。
把脚本能力包成真正的命令行工具：用 Click 8.5.0 的装饰器、命令组与共享上下文声明参数与子命令，再用 Typer 0.27.3 的类型标注重写同一个工具，真跑帮助、统计、词频与退出码，并用 CliRunner 把 CLI 层测透，完成工程化的分层与测试。
本附录是按症状索引的排查手册，把启动、配置、数据库与事务、测试四类共二十余个常见问题整理成「症状 → 可能原因 → 排查步骤 → 解法 → 详见章节」，覆盖端口占用、Bean 创建失败、配置不生效、YAML 报错、连接超时、事务不回滚、测试注解变更等，末尾附错误关键字总索引表。
解释在事件循环线程上执行阻塞调用为何会拖垮整个服务，厘清 publishOn 与 subscribeOn 的语义差异与常见误用，说明 Schedulers.boundedElastic() 为何专为阻塞设计（本机实测默认 100 线程上限），并给出 BlockHound 检测与 WebFlux 阻塞执行隔离的配置方法。
多实例部署时 @Scheduled 会在每个实例重复执行，同一笔罚金被算三次。本节讲清三种去重解法（数据库锁、Redis 锁、交给调度中心）、ShedLock 的定位、任务幂等设计（幂等键、状态机、可重入）、执行记录与三类告警，以及错过执行后的补偿方案。
本附录对照同一件事在 Maven 与 Gradle 下的写法：项目结构与构建文件、依赖与版本管理、Spring Boot 插件配置、常用任务对照、多模块组织与可执行 jar 打包差异，并给出选型建议。文中 Maven 示例已在本机 3.9.12 实测，Gradle 示例未实跑，仅作对照参考。
拆开 WebFlux 的请求处理链：DispatcherHandler 如何取代 DispatcherServlet、响应式 HandlerMapping 与 HandlerAdapter 各自返回什么、返回 Mono 的控制器方法如何被 HandlerResultHandler 适配成响应，以及 WebFilter 与 Servlet Filter、函数式端点与注解式端点的取舍。
以每月结算逾期罚金为例讲透 Spring Batch：Job、Step、chunk 模型与事务边界、JobRepository 元数据表、JobParameters 与失败重启、跳过与重试策略，并诚实说明几万行以内的批处理用一句 SQL 往往比它更划算。
本附录把 Spring Boot 最常用的配置项按服务器、应用、数据源、JPA、Jackson、日志、Web 资源、校验、Actuator、Flyway 十类汇总成速查表，每项标注默认值、作用与对应正文小节，并附 3.x 到 4.x 的配置项迁移对照表，涵盖 Jackson 属性改名、MongoDB 与 Session 前缀调整等变更。
本节讲批量改写 TypeScript 代码的完整方法论。先对比三类手段：语言服务的安全重命名、Compiler API 与 ts-morph 的结构化改写、文本替换的取舍；再用 ts-morph 写出一个可批量运行、幂等的 codemod，并处理打印格式、dry-run、回滚与验证。读完本节，你能把一次跨上百个文件的重构做成可重复执行、可审阅、可回滚的工程流程。
本节先厘清「tsPlugin」在 TS 生态里的三种含义：语言服务插件、编辑器扩展与编译期 transformer 极易混淆。重点是语言服务插件——模块导出约定、用 Proxy 包装 LanguageService 覆盖方法、拿 Program 与 TypeChecker 做语义分析、注入自定义诊断，以及调试与性能红线。读完本节，你能写出真正生效、可调试、不拖垮 TS Server 的插件。
本节从编辑器里那次「跳转到定义」讲起，说明 IDE 的类型提示并非由 tsc 提供，而是由一个常驻的 TS Server 进程回答。你会弄清 TS Server 私有协议与 LSP 的分工、Project 的加载策略与生命周期，以及如何在 Node 中直接向它发请求做批量查询。读完本节，你能看懂编辑器日志里的协议报文，也为下一节编写 tsPlugin 打好基础。