Ymir Tool 指南中心

Sprint 3 案例与排错页

这些页面按具体故障组织：JSON 语法、API 响应、大整数、Base64 变体、URL 查询参数、正则表达式、文本差异、时间戳和发布复核。每页都包含坏样例、修复样例、错误表、隐私边界和相关工具入口。

JSON/API 调试

• JSON 尾随逗号与单引号错误排查

  用最小样例定位 JSON 尾随逗号、单引号、未加引号 key、注释和日志前缀导致的格式化失败。

• API 响应 JSON 调试清单

  从状态码、Content-Type、响应体外壳、JSON 结构和字段类型五个层次排查 API 响应异常。

• JSON.stringify 与 JSON.parse 数据丢失排查

  说明 stringify/parse 往返中 undefined、函数、Date、大整数、NaN、Infinity 和循环引用的常见数据丢失。

• JSON 大整数精度丢失指南

  排查订单号、雪花 ID、广告点击 ID、数据库主键等大整数在 JSON 与 JavaScript 中被舍入的问题。

Base64/编码

• Base64 Padding 错误排查指南

  解释 Base64 末尾等号、长度不是 4 的倍数、换行、URL-safe 字符和复制截断导致的解码失败。

• Unicode 文本与 btoa/atob 乱码排查

  说明中文、emoji 和非 Latin-1 字符在浏览器 btoa/atob 中出现异常的原因与 UTF-8 转换流程。

• Base64URL 与标准 Base64 差异指南

  对比标准 Base64 和 Base64URL 的字符表、padding、JWT 场景、URL 参数传输和互相转换风险。

• Base64 不是加密：安全边界说明

  解释为什么 Base64 只能编码不能保密，适合传输和表示字节，不适合保存密码、隐藏 token 或保护隐私。

URL/查询参数

• URL 查询参数编码指南

  说明 query key、query value、完整 URL 和路径片段的编码边界，避免中文、空格、斜杠、问号和等号被误解析。

• encodeURI 与 encodeURIComponent 区别

  用示例解释完整 URL 编码和组件编码的差异，避免斜杠、问号、井号、等号和 & 被错误保留或转义。

• URL 重复编码排查

  定位 %25、%252F、%253D 等重复编码现象，判断参数被前端、后端、代理或平台二次处理的位置。

• URL 中 + 与 %20 空格差异指南

  解释 query、表单编码、路径和普通百分号编码中 + 与 %20 的差异，避免搜索词、邮箱和签名参数被误读。

Regex/文本处理

• 正则贪婪与惰性量词排查

  用可复制样例解释 .*、.*?、字符类和边界条件，避免正则匹配过多或性能异常。

• 正则捕获组调试指南

  说明括号分组、命名组、非捕获组、可选组和替换引用的排查方法，避免字段错位。

• JavaScript 正则 flags 使用指南

  解释 g、i、m、s、u、y 等 JavaScript 正则 flags 对匹配、换行、Unicode 和 lastIndex 的影响。

• 文本对比中的空格与换行差异指南

  排查 CRLF/LF、尾随空格、Tab、不可见字符和格式化差异对配置、文案、代码片段的影响。

时间/校验/发布复核

• Unix 时间戳秒与毫秒区别

  用位数、示例和排查步骤区分 10 位秒级、13 位毫秒级、16 位微秒级和 JavaScript Date 毫秒输入。

• 日志时区错位排查指南

  排查 UTC、本地时区、服务器时区、数据库时区和浏览器显示时区导致的日志时间错位。

• MD5 文件校验流程

  说明如何使用 MD5 做下载文件、配置片段和发布包的一致性核对，并区分安全签名与兼容校验。

• 发布前复制粘贴复核清单

  面向配置、URL、JSON、正则、时间戳和文案发布，提供复制前后必须检查的输入来源、处理动作和目标系统验证清单。