Vue 运行报错与水合排查

原名：vue-debug-guides

按复现条件排查 Vue 警告、异步错误及服务端水合差异。

中文 Skills 技能说明

页面偶发白屏或出现 Vue 警告时，先保留完整复现信息。提供错误堆栈、浏览器环境、组件、请求及服务端渲染条件，技能按包内分类指南梳理运行异常、异步处理、组件生命周期和水合差异，交付排查顺序与候选修复。需要项目源码和可运行环境，相关调试工具另配；日志应去除账号、令牌和个人信息。区分猜测与已复现原因，不能靠吞掉异常或关闭警告掩盖故障，修复前后需验证同一路径，生产修改另行确认。

上游能力依据

上游原始适用说明：Vue 3 debugging and error handling for runtime errors, warnings, async failures, and SSR/hydration issues. Use when diagnosing or fixing Vue issues.

上游 SKILL.md 主要章节（保留原文标题）：

• Reactivity
• Computed
• Watchers
• Components
• Props & Emits
• Templates
• Template Refs
• Forms & v-model
• Events & Modifiers
• Lifecycle

使用边界

先复现问题并固定测试范围，再生成或执行测试。测试通过只能证明已覆盖的场景，不能代替生产环境验收。

作者、翻译与许可证

原作者

hyf0、SerKo 与 vuejs-ai/skills contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/vuejs-ai/skills/tree/198f0cd8f7f9c0a3d9b566ccc16de6677519ee78/skills/vue-debug-guides

适用范围

平台：linux、macos、windows；标签：测试与质量、Vue 运行报错与水合排查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。