摘要
全局错误日志在 install 时尝试创建日志目录并写入 logger_boot 行，再把 Vue 的 errorHandler 接到统一 logError。排查「仅有控制台无文件」时，应检查 getApplication().FileSystem 与数据目录权限。
关键词
日志;errorHandler;Vue
扩展阅读与维护提示
本篇围绕「installGlobalErrorLogger：启动写盘与 Vue 错误钩子」组织材料。仓库内与主题最直接相关的检索词包括：日志、errorHandler、Vue。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。
摘要所概括的要点为：全局错误日志在 install 时尝试创建日志目录并写入 logger_boot 行，再把 Vue 的 errorHandler 接到统一 logError。排查「仅有控制台无文件」时，应检查 getApplication().FileSystem 与数据目录权限。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。
教程文件名「35-quanju-rizhi-yu-Vue-errorHandler.md」仅用于导航与排序，不等价于源码模块名。若正文中的行号与本地分支不一致，多半因合并导致行偏移，此时应以函数名、导出名为锚重新检索；团队若维护了生成脚本，可在变更大段源码后重新运行以保持摘录大致对齐。
本文刻意避免对产品能力做营销式承诺：所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型，应在网关、证书与代理层收口，而不是假设加载项能绕过浏览器安全模型。
若你同时阅读 docs/chayuan-llm-chain-series，可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序，再回到本教程看数据结构、默认值与修改风险面；两者互补，不重复堆砌功能列表。
正文
1. 安装流程
prepareLogDirectoriesOnInstall 与 writeLogLine(logger_boot)。
阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。
// src/utils/globalErrorLogger.js 第544-570行 export function installGlobalErrorLogger(app) { if (!app) return try { prepareLogDirectoriesOnInstall() const fs = getApplication()?.FileSystem const dir = getLogsDir() if (fs && dir) { const abs = tryEnsureLogDir(fs, dir) maybeCleanupOldLogs(fs, abs) } } catch (e) { void e } try { writeLogLine( safeStringify({ ts: new Date().toISOString(), type: 'logger_boot', logsDir: getLogsDir(), ua: typeof navigator !== 'undefined' ? navigator.userAgent : '' }) ) } catch (e) { void e }2. Vue 错误处理
app.config.errorHandler 包装 logError，携带组件名等上下文；注释说明不在此处弹层以避免渲染期递归。
阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。
// src/utils/globalErrorLogger.js 第572-580行 app.config.errorHandler = (err, instance, info) => { logError('vue_error', { info: String(info || ''), error: normalizeValue(err), component: instance?.$options?.name || instance?.type?.name || '' }) console.error('[Vue Error]', info, err) // 不在此处弹层：避免渲染期错误 → 弹窗 → 再次触发 Vue 更新形成递归。 }
