posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
本节说明 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 互转。再讨论异步流程中把错误搬进类型签名的写法，并划清预期业务错误与意外异常的分工。
本节用图书借阅服务 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 的状态码控制，并说明为什么在每个控制器里重复写处理方法是不可持续的。