posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
构建产物 sdist 与 wheel 到底差在哪？本节逐段解码 wheel 文件名，真实跑一次 python -m build，把 wheel 装进临时 venv 执行 console_scripts 命令，再讲清包数据、入口点插件、twine check、TestPyPI 与 PyPI 的上传流程，以及版本号不可复用这条硬规则。
从 setup.py 与 requirements.txt 的历史包袱讲起，用 PEP 518/517/621 三条线串起 pyproject.toml 的来历；拆解 build-system 后端选型与 project 表标准字段，重点实测依赖说明符中 ~= 的锁定边界与逗号、空格的区别，并给出经 tomllib 校验的完整配置。
以秋冷糖是否公开不完整风险为样章，模拟如何把专业判断、制度压力、普通人代价和人物责任写进关键选择。
本节用图书管理服务的 BookService 与 BookRepository 对比构造器、Setter、字段三种注入方式，解释官方为何推荐构造器注入，演示 @Qualifier 与 @Primary 解决同类型多 Bean，并拆解五种作用域与 prototype 注入 singleton 的经典陷阱及两种解法。
本节解决异步编程里最容易被忽略的三个问题：并发数不受控、任务无法取消、请求没有超时。我们手写一个泛型并发池，把 AbortController 与 AbortSignal 的取消链路讲透，用 AbortSignal.timeout 与 Promise.race 实现两种超时方案，再给出指数退避重试与竞态防护的写法，读完你能写出可控、可中断、可观测的异步批处理代码。
本节把 Promise 当成带类型参数的状态机来拆解：Promise<T> 里的 T 描述什么，then、catch、finally 如何传递与拓宽类型，async 函数为什么必须返回 Promise<T>，await 又做了怎样的解包。我们用表格对比 all、allSettled、race、any 的类型差异，讲清串行与并行 await 的性能陷阱，并给出类型安全的请求封装写法。
本节把「错误」当成类型问题来讨论：为什么 catch 的参数只能是 unknown，如何用自定义错误类配合 instanceof 收窄，以及如何用判别联合把失败编码成返回值。我们会手写一个带 map、mapErr、unwrap 的 Result 类型，并用表格对比异常与 Result 各自的适用边界，读完你能为业务代码选出一套可推导、可穷尽检查的错误处理方案。
本节从一段手写 new 的代码讲起，说明 IoC 到底反转了什么，理清 ApplicationContext 与 BeanFactory 的关系，逐一演示 @Component、@Bean、@Import 把类变成 Bean 的三种方式，并用 getBeanDefinitionNames() 实测打印容器内容，帮你判断哪些类该交给容器、哪些不该。
从 pytest-cov 的实跑报告讲起，说明 100% 行覆盖不等于测到边界，用 --cov-branch 对比数字；再实跑 ruff check/format 与 mypy --strict，给出 pyproject 配置段，最后落到 pre-commit 与 GitHub Actions，把质量门禁分成本地、CI、发布前三层。
把测试从单条函数升级为可复用、可组合的工程：讲清 fixture 的参数注入与四种作用域、yield 拆解、conftest.py 层级发现、tmp_path 与 monkeypatch，再用 parametrize 和 unittest.mock 演示 patch 该打在哪一层、autospec 与 call_args 怎么用。
从 unittest 的写法对比切入 pytest：讲清 test_ 前缀的自动发现规则、assert 断言重写为何能给出逐元素 diff、pytest.raises 与 match、pytest.approx 浮点比较、skip/skipif/xfail 三种标记，以及 src 布局、pyproject 配置与 -v/-k/-x/--lf 常用开关。
以《孢子危机》开篇雨后前兆为样章，模拟如何通过孩子感知、普通日常、自然线索和信息误判写出危机的第一层不安。
逐个讲透 @ConditionalOnClass、@ConditionalOnMissingBean、@ConditionalOnProperty、@ConditionalOnWebApplication、@ConditionalOnBean 等条件注解，每类配一个最小可运行示例，并说明评估顺序的坑与如何用条件装配实现「按配置开关功能」。
顺着 @EnableAutoConfiguration 一路追到 AutoConfigurationImportSelector 与 AutoConfiguration.imports 清单文件，讲清 3.x/4.x 的加载路径、4.0 模块化后包名的迁移规律，并用 --debug 打印的自动配置报告解读 Positive/Negative matches。
本节把校验真正落到工程上：先列出一份完整的边界清单，再逐个给出落地方式——环境变量启动期校验并 fail fast、封装带 schema 的 typedFetch 解析上游响应、用泛型中间件校验 HTTP 请求体、区分 4xx 与 5xx 的错误归属、用 strict 与 passthrough 处理契约演进，最后用契约测试把前后端对齐。读完你能在自己的项目里搭出一套完整的边界防线。
本节介绍如何在运行时检查数据形状：用 Zod 声明 schema，用 z.infer 让编译期类型自动推导，告别「类型与校验规则各写一份」的漂移。内容覆盖 parse 与 safeParse 的取舍、issues 结构、optional/default/transform/refine 等修饰、z.input 与 z.output 的差异、判别联合与递归 schema，以及常见坑。
本节从类型擦除讲起：TypeScript 编译时会把 interface、类型注解与断言全部抹掉，只留下 JavaScript，于是「编译通过」并不等于「运行时安全」。我们会逐一拆开真实项目里最容易出事的几类盲区，包括 JSON.parse 后的断言、越界索引、Object.keys 的字符串键、结构化类型的多余属性、非空断言与异步回调，并给出信任边界清单，帮你判断校验该加在哪里。
从「我什么都没配，Tomcat 怎么就起来了」这个疑问出发，逐层拆开 @SpringBootApplication 背后的三个注解：@SpringBootConfiguration、@EnableAutoConfiguration 与 @ComponentScan，用等价代码验证，并给出包扫描与 exclude 的常见误用与排查方法。
同步库直接写进 async 会阻塞整个事件循环。本节用本地服务实测 requests 串行、to_thread 与 httpx.AsyncClient 的耗时差，讲连接池、contextvars、async for 与 async with，并盘点假异步：忘记 await、循环里串行 await、create_task 丢引用，最后说明何时不该用异步。
create_task 立刻调度、gather 要 await 才跑。本节对比 gather 与 TaskGroup 的错误处理：gather 不取消兄弟任务，TaskGroup 会取消并用 ExceptionGroup 汇总；再讲 asyncio.timeout、shield、CancelledError 的 BaseException 语义、Queue、Semaphore 与 Runner。