调试Codeium日志时，效率的关键在于先激活日志记录，再按照实际遇到的现象定向排查，无需逐行通读全文。代码补全无响应？检查`getCompletions`的请求响应与缓存状态；补全内容错乱？对比`languageId`与文件类型是否匹配；认证失败？搜索`auth`错误以及`token`过期标志。结合`grep`精准筛选关键日志行，多数根因能快速定位。
换句话说，你在IDE中观察到的具体现象决定日志分析的切入点。补全不触发、提示冻结、错误弹窗、登录失败——每种场景对应的日志段落截然不同，精确捕捉关键词与时间戳，即可绕过无效搜索。
## 第一步：验证日志采集是否启用
前往Codeium插件设置 → 定位「Enable Debug Logging」并开启 → 重启IDE。此步骤不可省略，否则后续日志全部为空。
**【若未开启Debug Logging，~/.codeium/logs/目录下仅存在空文件或完全无日志生成】**
等待约10秒后，进入用户主目录下的`~/.codeium/logs/`（macOS/Linux）或`%USERPROFILE%\.codeium\logs`（Windows），检查是否存在以当天日期命名的新日志文件。如果不存在，表明日志仍未生效，请重新验证设置中的开关是否已正确激活。
## 根据典型症状选择日志分析入口
症状不同，日志排查的起始点迥异：补全无响应应检查request/response链路；登录失败优先筛查auth相关错误；界面卡顿则关注latency字段与pending状态。以下分三种常见场景详解。
## 场景一：代码补全完全缺失（空白弹窗或无任何响应）
① 在最新日志文件中检索`"getCompletions"`，定位最近一次请求的完整记录块。
② 查看该记录块中是否包含`"response": null`或`"error": "timeout"`等内容。
③ 若发现`"isCached": true`但返回结果为空，则说明本地缓存异常——删除`~/.codeium/cache/`目录后重新触发补全即可恢复。
## 场景二：补全弹出但内容异常（乱码、重复字符、语言不匹配）
在日志中搜索`"languageId"`，核对它的值是否与当前文件扩展名对应。例如编写`.tsx`文件时，日志却显示`"languageId": "ja vascript"`，表明Codeium对文件类型判断有误。修复方法：在IDE右下角点击语言选择器，手动切换至正确语言，重新触发补全后检查日志中languageId是否已更正。
## 场景三：IDE弹出「Failed to authenticate」或登录按钮不可用
搜索`"auth"`或`"login"`，找到包含`"status": 401`或`"invalid_token"`的行。然后向上查找最近的`"token_expires_in"`字段，若值≤0，表示令牌已过期。执行登出操作后重新登录即可解决。**警告：切勿勾选「Remember me」**，该选项在某些IDE中会将已失效的令牌持久化，导致认证错误反复出现。
## 高效筛选关键日志行
进入日志目录后，使用命令行工具最为快捷。推荐以下两条实用命令：
```bash
# 快速捕获所有异常标志（错误、超时、4xx状态码、未授权）
grep -E "(error|timeout|40[0-9]|unauthorized)" latest.log
# 查看成功响应的前后文，确认提示词是否被截断或模型参数异常
grep -A 3 -B 1 "getCompletions.*200" latest.log
```
这两条命令可助你在数秒内定位绝大多数问题，避免逐页手动翻阅日志。
