app.config 应用配置对象
最后更新:2026-10-22
app.config 应用配置对象
app.config 提供应用级配置:errorHandler、warnHandler、globalProperties、performance 等。
| 分组 | 全局 API |
|---|---|
| 类型 | API |
| 作用域 | 全局 |
| Vue 版本 | 3.0+ |
| SSR 支持 | 支持 |
📝 语法
app.config.errorHandler = (err, vm, info) => { /* 上报 */ }
app.config.globalProperties.$http = http
返回值:配置对象本身
▶ 示例
修改下面的代码,在预览区实时查看效果:
输出:
点按钮后控制台输出「统一捕获: 演示错误」,页面不崩。
💡 要点
💡 提示 errorHandler 是接入监控平台(Sentry 等)的标准入口。
ℹ️ 说明 globalProperties 挂载的成员在所有组件通过 this 访问(替代 Vue 2 的 Vue.prototype)。
⚠️ 注意 配置要在 mount 前设置;生产环境 warnHandler 不触发(仅开发)。
🏷️ 相关全局 API
💡 相关案例
更多案例即将上线。
📚 相关教程
❓ 常见问题
Q errorHandler 捕获哪些错误?
A 组件渲染/生命周期/侦听器抛出的错误(未被子级 errorCaptured 截断的)。
Q globalProperties 有类型提示吗?
A TypeScript 需声明 ComponentCustomProperties 扩展,否则没有类型。
Q 能改编译器选项吗?
A 可以(compilerOptions),如自定义分隔符;仅限完整版。