全部文章
接口错误响应应该怎么设计
以前联调接口，后端 500 只回一段文本，前端 res.json 直接抛 SyntaxError，真正的错误被吞掉，只能弹未知错误。我后来花一个小时定了统一错误格式，前后端省下的调试时间远超十倍。
Linux 服务器排查日志的基本命令
默认的 combined 日志能告诉我谁访问了哪个地址，但说不清慢请求是卡在 nginx 还是后端。我加了带毫秒和 upstream 耗时的 log_format，然后连踩三个坑：awk 字段偏移、面板报表变空、历史日志不跟着变。
Redis 缓存常见使用方式
改完首页布局传上服务器，无痕窗口和清缓存都试过，页面还是老的。文件名带 hash 也没用，问题出在 Nginx 给 HTML 设了缓存头。这篇顺便记了缓存失效为什么比加缓存难，以及什么情况下才真该上 Redis。
数据库索引的基础理解
一个 200 万行的表，按 author_id 查详情要 8 秒，EXPLAIN 出来是全表扫描。对方说应该有索引吧，指的却是主键。这篇从那次翻车讲起：索引是什么、哪些字段该建、为什么不是越多越好、联合索引的最左前缀。
Git 分支工作流的基本习惯
这个博客项目到现在都没建 git 仓库，但分支工作流我在上一家用得很多，踩过坑。这篇记分支命名、提交粒度、rebase 和 merge 怎么选、合并前的四个动作，以及怎么避免直接 push 到 main。
Nginx 静态资源缓存配置思路
首页慢三秒最先查出来的东西是一张 12MB 的背景图，每次刷新都完整重下一遍。我从构建产物长缓存、HTML no-cache、图片规则、304、gzip_static 一路加到 open_file_cache，最后留了一份每加一类资源都要过的清单。
Vite 环境变量和构建配置入门
本地构建时 BASE_URL 写的是线上域名，CSS 里硬编码打进 bundle，后台接口地址全错，排查花了俩小时。这篇记 Vite 的环境变量命名规矩、按环境分文件、自定义 mode，以及一次把真密钥写进 env 文件的翻车。
Vue Router 导航守卫的常见用法
我这个博客是 Vue 3 写的，但没用 vue-router，路由是手写 pushState。不过守卫那套思路通用：登录校验、页面标题、滚动位置。这篇是当时研究 vue-router 的笔记，已经改成手写路由也能直接用的版本。
Python 项目为什么要使用虚拟环境
三年前我电脑里两个项目共用全局 Python，装一个 httpx 0.22 直接把 Django 那边搞崩。从那天起每个项目必须有自己的环境。这篇是我现在的工作流，外加几个真实翻车：语法版本差异、python 命令找不到、rebuild 后忘装依赖。
FastAPI 路由拆分和依赖注入实践
后端最早只有一个 main.py，九个接口不到一百行看着很顺，接口一多就找不着了。我按功能拆成 routes 子文件，拆完跑不起来，因为 include_router 要 import 和注册两步都做。后面讲依赖注入除了拿数据库还能干什么。
Nginx 反向代理和负载均衡入门
第一次配反代，接口通了但后台死活登不上，session 每次都丢，原因是 Set-Cookie 在代理过程中被改了。这篇从那次开始，讲 upstream、健康检查、负载策略、请求头和几个常调的超时参数。
Python 装饰器：把重复逻辑收起来
第一次写装饰器我漏了 wraps，函数的名字和文档字符串全变成 wrapper 的。后面记计时、权限校验、缓存、重试四个真在用的装饰器，以及它们各自在哪儿翻过车。
Vue3 中 ref 和 reactive 怎么选
Vue 3 刚出那会儿我还带着 Vue 2 的 data 思维，把表格组件写错了。这篇记 ref 和 reactive 我现在怎么选、reactive 当函数入参和解构时丢响应性的两次翻车，还有团队约定为什么能省一半心智。
前端的安全默认值：CSP、上传与同源
个人网站最容易忽略的安全细节：富文本渲染、文件上传和同源策略。三道防线的“默认值”设计思路。
第一篇笔记：把知识写下来
搭这个博客前我给自己定了条规矩：没有多人同时写、没有事务需求，就不上数据库。13 张表全用 JSON 文件，读写加起来不到五十行。代价是第二天就丢过一次数据，而脚本当时还打印了成功。
给博客定一个性能预算：首屏 150KB
给自己的博客定了条硬规矩：首屏关键资源不超过 150KB。用这条预算倒推出来的优化清单，比任何泛泛的“性能优化建议”都管用。
从 JSON 到 SQLite 到云：个人项目的存储升级路线
个人项目的数据存储不必一步到位。JSON 文件、SQLite、云数据库三级台阶，每一级的切换信号和成本都不一样。
uv 用了半年：Python 依赖管理的新默认
从 pip + venv 切到 uv 半年之后，安装速度、锁文件、多版本 Python 管理三件事都回不去了。讲讲迁移成本几乎为零的切换方式。
2026 年回头看：FastAPI 还是 Python 后端的甜点位吗
用了三年多 FastAPI 之后回头评估：新框架层出不穷，它依然是大多数 Python 后端项目的最优默认选择，理由和边界都在这篇。
AI 时代的测试：让生成物守护生成物
AI 能生成测试用例，但“生成一堆用例”和“有效的测试体系”是两回事。聊聊 AI 辅助测试的正确打开方式：人定策略，AI 补人力。