WakaTime插件无数据需先确认~/.wakatime.cfg是否生效；项目名显示“Unknown Project”因未识别Git根目录或缺少.wakatime-project文件；命令行超时需检查代理及SSL设置；统计不准常因timeout过短或hidefilenames启用。
WakaTime 插件装了但没数据？先确认 ~/.wakatime.cfg 是否生效
WakaTime 在 VSCode 里“看似启用”，实际常因配置文件缺失或路径错误导致完全不打点。它默认读取用户主目录下的 ~/.wakatime.cfg（Windows 是 %USERPROFILE%\wakatime.cfg），而不是 VSCode 设置里的 API key 字段——后者只用于首次登录，后续全靠本地配置文件驱动。
常见错误现象：WakaTime: Not authenticated 报错反复出现，或 VSCode 状态栏显示 “WakaTime: Idle” 却始终不变成 “WakaTime: Tracking”；后台日志（~/.wakatime.log）里频繁出现 Connection refused 或 No such file or directory: ~/.wakatime.cfg。
- 手动创建
~/.wakatime.cfg，写入至少两行：[settings] api_key = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- 确保文件权限不开放（尤其 macOS/Linux）：
chmod 600 ~/.wakatime.cfg，否则 WakaTime 会拒绝读取 - VSCode 必须重启（不是重载窗口），插件启动时只读一次该文件
为什么项目名总显示为 “Unknown Project”？关键在 .wakatime-project 或 Git 根目录
WakaTime 默认用当前打开文件的**最靠近的 Git 仓库根目录名**作为项目名。如果没 Git，或者你开的是子目录（比如 /src/backend 但 Git 在 /），它就 fallback 到 “Unknown Project” —— 这直接导致统计页面里所有时间堆在同一个模糊条目下，无法区分真实项目。
使用场景：你同时开三个微服务目录（user-service、order-service、gateway），但它们各自是独立 Git 仓库；或你在 monorepo 里按包切换，需要精确到 packages/ui 级别。
- 最稳方案：在每个项目根目录放一个
.wakatime-project文件，内容就是你想显示的项目名，比如frontend-vue3 - Git 方案：确保每个项目有独立
.git目录；monorepo 下可在各子包内初始化空 Git 仓库（git init && git commit --allow-empty -m "init"），WakaTime 能识别 - 避免用 VSCode 工作区文件（
.code-workspace）命名项目——WakaTime 不读它
wakatime-cli 命令行卡住或报 TimeoutError？检查代理和 SSL 验证
VSCode 插件底层调用的是 wakatime-cli（Python 写的命令行工具），它在后台静默上传心跳。如果你公司网络走代理、或系统证书库老旧（比如某些 Linux 发行版没更新 CA bundle），就会卡在 POST https://api.wakatime.com/api/v1/users/current/heartbeats，最终超时丢弃记录。
性能影响：单次超时不会崩插件，但连续失败 5 次后，WakaTime 会暂停 5 分钟再试，这期间所有编辑行为不计时。
- 临时验证：终端运行
wakatime --test，看是否返回Success: Authorized - 代理设置：在
~/.wakatime.cfg加上[settings] proxy = http://your-proxy:8080
（支持 http/https，不支持 socks） - SSL 问题：加
[settings] ssl_verify = false
（仅调试用，生产环境应更新系统证书）
每天耗时统计不准？注意 timeout 和 hidefilenames 的副作用
WakaTime 默认每 2 分钟发一次心跳，但如果你写代码时经常切出 VSCode（查文档、聊 Slack）、或长时间停在某个文件不动，它会按“最后活跃时间 + timeout”合并记录。这就导致：你以为写了 1 小时，实际被拆成 30 次 2 分钟片段，再被后台聚合成“1h02m”，但项目维度可能错配到你切屏前打开的文件上。
另一个坑是 hidefilenames = true（部分企业部署强制开启），它会让所有文件路径脱敏为 unknown，进而让 WakaTime 无法判断“同一项目下不同文件”的归属，项目统计直接失真。
- 调高
timeout可减少碎片：在~/.wakatime.cfg加[settings] timeout = 120
（单位秒，最大 300） - 禁用
hidefilenames：确认配置里没有这行，或显式设为false - 真实项目时间 ≠ 编辑器前台时间：它只统计键盘/鼠标活动触发的“编码事件”，纯阅读、搜索、终端操作不计入
~/.wakatime.log）就去查 dashboard，大概率看到的还是过期行为。 
