📦 v1.3 → v1.8 重要更新汇总：从「能跑」到现代化的小程序监控基建

[lizhiyao]

最近半年 sentry-miniapp 经历了一次比较大的迭代，趁这次发文也把更新一并理一下，方便已经在用的团队评估升级，也方便新接触的同学快速判断「现在的 sentry-miniapp 长什么样」。

这一轮更新解决的核心问题

1. 微信「构建 npm」相关的接入卡点（v1.3.0）
旧版本依赖 @sentry/core 时，微信开发者工具的「构建 npm」在处理嵌套 @scope 包时存在已知缺陷，会报 module 'miniprogram_npm/...' is not defined。v1.3.0 把构建工具迁到 Vite，采用 bundle-inline 策略，对外零依赖 —— 只需安装 sentry-miniapp 一个包，再点「构建 npm」就能直接跑。

2. 多端 Source Map 路径无法对齐（v1.3.0+）
不同小程序运行时给出的堆栈路径是各自的虚拟路径，无法直接和构建产物匹配。v1.3.0 内置了路径自动抹平到 app:/// 语义，配合 sentry-cli 上传 sourcemap 后能直接定位到源码行。

3. 上下文不够丰富（v1.4 / v1.5）

• v1.4 的 NetworkBreadcrumbs 可以抓 Request / Response Body
• v1.5 新增了页面生命周期、用户交互、Console 三类 Breadcrumb
• 配合 Performance 集成、tracesSampler 动态采样（v1.7），后台看到的不再只是「报错了」，而是完整的用户路径 + 请求链路

4. 包体积（v1.6）
启用 esbuild 压缩，包体积减少 ~59%。

速查表

版本	一句话亮点
v1.8	AI 辅助接入 skill（Claude Code / Cursor）
v1.7	tracesSampler 动态采样 + Source Map 完整配置指南
v1.6	13 项功能优化 + 16 项问题修复 + 包体积 -59%
v1.5	Performance 增强 + 页面 / 交互 / Console Breadcrumb + Route 全平台适配
v1.4	抓 Request/Response Body + 离线缓存可配 + captureFeedback
v1.3	Vite 重构 + 零依赖 + Source Map 路径自动抹平

完整变更见 CHANGELOG.md。

延伸阅读

如果你想看更系统的接入思路（包括 Source Map 实战、弱网兜底、跨端差异），可以看这篇文章：
👉 《我把 Sentry 接进了 7 端小程序：从异常捕获、Breadcrumb 到 Source Map 定位》

欢迎留言

• 你正在用 sentry-miniapp 解决什么样的问题？
• 升级到 v1.x 之后有遇到任何卡点吗？
• 哪些场景下你希望它能做得更好？

任何反馈、踩坑经验、改进建议都欢迎在这里聊。