一份写给下次自己的工程手册

做过的事,
下次直接接着用。

这里收着项目里真正用过的代码、排错过程和配置。文章不追热点,只把问题发生在哪里、最后怎么处理写清楚。

50篇完整笔记
3个问题领域
68段代码与配置
0个失效入口
精选笔记

最近最常翻的几篇

查看全部文章
前端与浏览器9 分钟

从 HTML 到像素:浏览器渲染流水线怎么工作

浏览器不会直接把 HTML 画到屏幕上。本文拆解主线程上的解析、样式计算、布局和绘制,以及合成线程如何复用图层。

RenderingDOMCSSOMPerformance
前端与浏览器10 分钟

HTTP 缓存策略:强缓存、协商缓存与版本化资源

从 Cache-Control 的语义出发,为带哈希静态资源、HTML、接口数据和用户私有数据设计可预测的缓存策略。

HTTP CacheCache-ControlETagCDN
前端与浏览器9 分钟

Cookie 安全边界:SameSite、HttpOnly 与 CSRF

解释 Cookie 的发送规则、安全属性、跨站与跨源差异,并给出会话 Cookie 和 CSRF 防护建议。

CookieSameSiteCSRFSession
服务端与数据9 分钟

Node.js 事件循环:别让一段同步代码拖住所有请求

Node.js 擅长并发 I/O,但 JavaScript 仍运行在主线程上。本文用可观测指标、任务分片和 Worker Threads 说明如何处理 CPU 密集型工作。

Node.jsEvent LoopPerformanceWorker Threads
服务端与数据10 分钟

API 分页:数据会变化时,用游标代替页码

offset 分页简单,但在数据持续新增或删除时会重复或漏掉记录。本文实现基于 created_at 与 id 的稳定游标分页。

REST APIPaginationPostgreSQLCursor
服务端与数据12 分钟

Node.js 文件上传:从流式处理到对象存储确认

安全的上传链路不止一个 multer 配置。本文覆盖流式接收、魔数检测、预签名直传、对象权限和上传确认。

File UploadStreamsS3Security
工程效率与质量9 分钟

Monorepo 不只是把仓库放在一起:用工作区守住模块边界

从目录职责、依赖方向和发布边界出发,搭建一个不会随着项目增长而失控的 Monorepo。

MonorepopnpmTypeScript模块化
工程效率与质量8 分钟

测试金字塔落地:按风险选测试,不按数量凑比例

从系统边界和故障成本出发选择测试层级,让测试套件既快又能发现真正的问题。

测试策略单元测试集成测试E2E
工程效率与质量8 分钟

线上故障前 15 分钟:一份能真正执行的 Runbook

明确指挥、止损、证据保全和沟通节奏,避免故障现场所有人同时猜原因。

故障响应Runbook可观测性复盘
怎么使用这个网站

先解决眼前的问题,
再补背后的知识。

直接复制前,先看适用条件

每篇文章都说明运行环境和取舍。代码只是起点,不是万能片段。

警告通常比代码更值钱

真正浪费时间的,往往是第一次实现时没有想到的边界。

内容会被重写,不会堆版本号

做法变了,就直接把文章改到现在可用的状态。