posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
本节解决工程中最隐蔽的一类问题：循环依赖与类型导入。先对比 ESM 与 CJS 下循环依赖的不同表现，解释暂时性死区与部分导出为何会让值在初始化阶段变成 undefined，再说明 import type 为什么能从产物中彻底消失、从而在结构上切断循环，随后对照三种类型导入写法的差异，最后给出检测工具与抽取共享类型的重构套路。
本节深入 package.json 的 exports 字段：先讲它如何取代 main 与 module 实现真正的封装，再拆解子路径映射、条件对象与数组回退三种形态，重点讲清条件键的顺序语义为何决定成败，然后对照 bundler 与 Node 在条件集合上的差异，最后给出一个可直接复制的双包库配置。读完你能自己写出既被 Node 认识、又让 TypeScript 找到类型的导出表。
本节把 TypeScript 的模块解析讲成一张对照表：先说明编译器为何要自己实现解析规则，再拆解 classic、node10、node16、nodenext、bundler 五种模式在扩展名与条件导出上的差异，再给出 module 与 moduleResolution 的合法组合，最后用三种典型工程配置收束。读完你能为任意项目选对模式，并看懂 Cannot find module 报错。
本节把视角从运行时可见性转向交付安全：先建立依赖供应链的威胁模型，再讲清 lockfile 与可复现安装的纪律、npm audit 与 OSV 扫描的差异、自动化升级与版本锁定策略。随后落到应用侧加固，涵盖用 Zod 在边界做运行时校验、安全响应头与 CSP、密钥管理与最小权限，最后给出 SBOM 与构建证明的落地方式。
本节讲透指标与告警这条链路：从 Counter、Gauge、Histogram 三种仪器类型的语义差异，到用 OpenTelemetry SDK 在 Node.js 里暴露 /metrics 端点，再到命名规范与标签基数控制。你将学会用 RED 与黄金信号设计仪表盘，写出可执行、低噪音的告警规则，并用 SLO 与燃烧率把告警从「阈值告警」升级为「错误预算告警」。
本节从日志排障的局限出发，讲清 OpenTelemetry 的 Trace、Span 与 Context 数据模型，并给出 Node.js 侧可直接运行的 SDK 初始化、自动插桩与采样配置。你将学会在 Fastify 中间件里手工埋点、跨服务传播 traceparent、把 trace_id 写进结构化日志，并用语义约定统一 span 属性命名，避开采样过高与上下文丢失等常见坑。
从 DelegatingFilterProxy 的延迟查找讲到 FilterChainProxy 的匹配：拆开 WebSecurityConfiguration 产出的 springSecurityFilterChain bean、HttpSecurity DSL 如何装配过滤器、FilterOrderRegistration 的排序规则，以及多条 SecurityFilterChain 的选取。
从 Actuator 端点暴露策略讲起，说明生产上为何只暴露必要端点与 env、heapdump 的风险，再拆解 Micrometer 的 MeterRegistry 模型与四类计量器，用 book-loan 演示自定义指标、公共标签、MeterFilter 与 percentiles-histogram，最后给出 Prometheus 抓取配置与开箱指标读法。
本节从 ddl-auto: update 的风险讲起，说明为什么表结构需要版本化迁移；点明 Spring Boot 4.x 的关键变更——Flyway 必须显式引入 spring-boot-starter-flyway。内容涵盖 spring.flyway.* 常用配置、默认脚本位置、首次启动日志与历史表结构，并给出与 Liquibase 的选型对比。
Python 3.14 的 PEP 649/749 让注解不再在函数、类、模块定义时求值，而是延迟到访问 __annotations__ 时才求值。本节实测 __annotate__、annotationlib 的三种 Format、缓存行为、前向引用与循环引用，以及 from __future__ import annotations 的关系。
把注解里的类型当运行时对象来看：list[int] 是 types.GenericAlias、int | str 在 3.14 已与 typing.Union 合并成同一个 C 类型，get_origin/get_args 与 Annotated 的解析口径，以及 isinstance 为什么拒绝参数化泛型——附本机实测的校验开销对比。
本书 1.2 节给过查找顺序的可观测结论，本节下沉到 C 实现层：object 与 type 两个 __getattribute__、元类上的描述符优先级、__get__/__set__/__delete__ 三件套，并用实测数据说明 __getattr__ 与 __getattribute__ 各把属性访问拖慢多少。
从「单个请求快」到「并发不雪崩」：用 concurrent.futures 与 time.perf_counter 自写小压测器打出 QPS 与延迟分位数，讲清容量曲线与 Little Law 的容量评估，真跑令牌桶限流（含 429 端到端）与超时兜底的降级策略，收成上线前的容量清单。
把瓶颈分成 CPU、内存、I/O 三类逐一击破：用 numpy 向量化与算法改进实测加速比，用 tracemalloc/getsizeof 实测 __slots__ 与生成器的内存收益，用批量、异步与连接复用实测 I/O 提速，最后给出按瓶颈类型选手段的决策表。
回到最前线的性能工作：用标准库 cProfile + pstats 贴出真实 cumtime/tottime 排序，用 pyinstrument 5.1.3 看采样调用树，用 timeit 做微基准、用 sys.monitoring 做轻量追踪，讲清如何读火焰图，并把「先测量再优化」立成本书的纪律。
《MMO 服务器开发》卷一《网络与并发内核》全书导航页：说明本卷定位、读者画像与前置知识、学习节奏与三条阅读路径，交代贯穿游戏《晨曦大陆》与从零服务端 aegis，讲清 Go 主线加 Java 对照的双栈口径与 L1–L4 可运行性分级，并按六个部分列出 18 章 54 节的完整章节索引，另含序、前言、附录 A–D 与常见问题速查表，方便读者按需定位、跳读与随时查阅。
《MMO 服务器开发》卷一序言：在框架随手可得的今天，为什么还要从零写一个 MMO 服务端。文章用三个真实场景说明「自己写一遍」换来的判断力，讲清本套书为什么选 Go 主线加 Java 对照、这一卷写什么不写什么、它和站内既有游戏服务端专题的分工，并给读者一段开始前的鼓励。
《MMO 服务器开发》卷一前言：交代本卷的技术选型与环境准备。列出实测的 Go 1.26 与 JDK 21 版本、Docker 拉取 Java 对照环境的完整命令与挂载坑、从零搭建 aegis 工作区的步骤，解释代码块头的 file/tier/verify 三行约定与 L1–L4 加 B 的可运行性分级，并给出 macOS 文件描述符上限、accept backlog、命令统计工具等实测踩坑清单。
客户端永远比服务端慢半步：你发了新版本，总有人还没更新。本节处理协议演进——登录时上报版本、服务端回带可用区间，以及字段级的向后兼容解码（新增字段填默认值、未知字段安全跳过），并真跑老客户端对新服务端、新客户端对老服务端两个方向的兼容用例。
TCP 是字节流，send 的边界不会传到对端——粘包与拆包由此而来。本节用长度前缀把流切成帧：给出 wire 布局、可复用缓冲的编码器、逐字节补齐的解码器与不可信长度的上限防护，并真跑一组覆盖粘包、拆包、截断、超长与畸形长度字段的测试用例。