JsonMind 指南
面向开发者的实战指南
聚焦开发者每周都会遇到的报错和取舍。每篇指南都关联一个浏览器工具，引用权威规范，并明确说明能力边界。
JSON 与数据
5YAML 缩进错误：修复 mapping values are not allowed here、Tab 与 Kubernetes 配置
修复 YAML 缩进错误：mapping values are not allowed here、Tab 与空格、块标量、列表缩进、锚点以及 Kubernetes 清单的常见写法。
CSV 转 JSON：引号、逗号、编码和嵌套数据怎么处理
避免 split 逗号导致的 CSV 解析错误，正确处理引号、换行、BOM、空值和类型转换，并给出可重复的校验流程。
JSON 解析报错：Unexpected token < in JSON at position 0 怎么修
解释 JSON.parse 常见报错的原因，区分 HTML 错误页、空响应、重复编码和非法 JSON，并给出可复用的安全解析写法。
JSON 转 TypeScript 类型：从示例到安全接口的完整流程
用真实 JSON 示例生成 TypeScript 接口，正确处理可空字段、可选属性、联合类型和大整数，避免生成看似正确却会运行时出错的类型。
JSON 和 YAML 有什么区别：语法、坑和选型建议
比较 JSON 与 YAML 的语法、注释、锚点、类型推断和解析安全，说明 API、配置、CI 与 Kubernetes 场景下该如何选择。
编码与文本
5Cron 表达式语法：常见写法、时区陷阱与验证方法
读懂并编写分钟、小时、日期与星期的 Cron 调度，避开日期字段的经典陷阱，并在上线前验证下一次运行时间。
正则表达式速查表：常用语法、模式与测试方法
一份面向实践的正则参考：锚点、字符类、量词、分组与环视，配合常用模式和避免灾难性回溯的检查方法。
Base64 中文乱码与 btoa 报错：原因和正确写法
解释 btoa 为什么处理不了中文、日文和 Emoji，演示 TextEncoder 与 TextDecoder 的正确 UTF-8 编解码流程，并排查乱码。
Unix 时间戳：秒和毫秒的区别与转换方法
讲清 Unix 时间戳的秒、毫秒、微秒单位，避免 1970 年和公元 57770 年错误，包含 JavaScript、SQL、JWT 和 cron 的转换示例。
UUID 和 ULID 怎么选：随机、有序与数据库索引的取舍
比较 UUID v4、UUID v7 和 ULID 的可排序性、索引友好度、URL 表示和分布式场景，给出新项目的选择建议。
安全与认证
3JWT 过期怎么排查：exp、iat、nbf 时间戳完全指南
理解 JWT 的 exp、iat、nbf 时间声明、秒与毫秒的区别和时钟偏移，快速定位 jwt expired、签名错误和算法不匹配。
JWT 和 Session 怎么选：撤销、扩展与安全边界
比较无状态 JWT 与服务端 Session 在撤销、扩展、XSS、CSRF 和移动端场景下的差异，给出可落地的选型建议。
密码哈希：为什么不能用 SHA-256，bcrypt 又该怎么配
从攻击者视角解释密码存储，比较 bcrypt、Argon2id 和 scrypt，说明盐、pepper、成本因子和迁移旧哈希的正确做法。
API 与接口
6HTTP 429 Too Many Requests：Retry-After、指数退避与重试风暴
讲清 429 的真实含义、Retry-After 的秒数与 HTTP 日期两种写法、带抖动的指数退避、幂等重试，以及限流、配额、并发限制和 CDN/WAF 429 的排查方法。
幂等键设计指南：支付与写操作 API 的安全重试
从超时重试导致重复扣款讲起，覆盖幂等键契约、UUID 与 ULID 生成、请求头约定、存储表与唯一约束、请求指纹、响应重放、TTL 和失败语义。
JSON Schema 校验失败：常见错误与修复方法
定位 JSON Schema 校验错误，理解 required、type、additionalProperties 与 format 的差异，并在数据进入业务逻辑前完成校验。
curl 转 fetch 或 axios：参数映射与常见坑
把 curl 的 -X、-H、-d、-F、-u 等参数准确映射到 fetch 和 axios，避免 Content-Type、重定向、错误处理和 CORS 问题。
CORS 预检请求失败怎么修：Access-Control-Allow-Origin 完整排查
从浏览器、curl 和服务端三个层面排查 CORS 预检失败，讲清允许来源、允许方法、允许头和 credentials 的正确组合。
API HTTP 状态码：400/401/403/422/429/5xx 怎么选和怎么排查
按客户端错误和服务端错误拆解 HTTP 状态码，讲清 400 与 422、401 与 403、409、429 重试以及 502/503/504 的排查顺序。
图片与媒体
3EXIF 元数据隐私：照片会泄露什么，如何安全删除
EXIF、XMP 与 IPTC 会暴露位置、设备和时间信息。本文说明哪些操作和平台会去除元数据，以及如何检查并验证删除结果。
网页图片压缩：不损失画质的完整流程
按尺寸、格式、质量、元数据的顺序压缩图片，并在用户实际看到的尺寸下验证效果，避免图片变小却更难看清。
WebP、AVIF、PNG 怎么选：网页图片格式实战指南
按照片、截图、透明图、动图分别比较 WebP、AVIF、PNG 和 JPEG，给出兼容性回退方案、压缩流程和 Core Web Vitals 注意事项。
文档与转换
3无障碍 PDF：标签结构、阅读顺序与发布前验证
讲清标签化 PDF 的结构树、阅读顺序、替代文本、标题与表格语义、语言元数据、OCR 文字层、转换损失，以及发布前的检查与修复顺序。
PDF 合并与拆分：不把文件上传到服务器的做法
在浏览器里合并、拆分、重排和压缩 PDF，理解页面级操作何时能保留版式、何时会破坏表单、书签与签名。
PDF 转 Word 为什么会格式错乱：能保留什么、会丢什么
解释 PDF 固定版式和 Word 可重排文档的差异，说明文字版与扫描版 PDF、OCR、表格和字体丢失的原因，并给出转换后的检查清单。
依据权威规范与引用来源复核。
JsonMind 指南由工程团队撰写和复核。我们会对照相关 RFC 或厂商文档检查内容，列出主要来源，并在行为变化时更新指南。
每篇指南末尾都列出了主要来源。