WakaTime统计异常主因是wakatime-cli未正确调用或配置错误：需检查日志报错、手动测试CLI运行、确认文件后缀与exclude规则；TS被计为JS需修改language_mapping；时长偏差源于2分钟heartbeat机制及离线缓存；多项目混计应使用.wakatime-project文件隔离。
WakaTime 插件没统计到 Python/JS 代码？检查 wakatime-cli 是否真正调用成功
VSCode 的 WakaTime 插件本身不统计，它只是把编辑行为转给本地的 wakatime-cli 命令行工具处理。如果某语言完全没数据，大概率是 wakatime-cli 没识别到文件类型，或根本没运行。
实操建议：
- 打开 VSCode 输出面板（
Ctrl+Shift+U），切换到WakaTime日志，搜索ERROR或WARN，重点看是否出现Failed to run wakatime-cli或Unsupported file extension - 手动在终端运行：
wakatime-cli --write --file /tmp/test.py --project test --time $(date +%s)，观察是否返回Success；失败则说明 CLI 安装异常或权限不足 - 确保文件有正确后缀（如
.py、.js），且没被.wakatime-project或wakatime.cfg中的exclude规则意外过滤
为什么 TypeScript 文件算成 JavaScript？改 language_mapping 配置
WakaTime 默认按文件后缀映射语言，.ts 和 .tsx 在旧版 wakatime-cli 中可能被归为 JavaScript，导致语言时长不准。
实操建议：
- 编辑
wakatime.cfg（路径通常为~/.wakatime.cfg或%USERPROFILE%\.wakatime.cfg） - 在
[settings]下添加：[languages] typescript = ts,tsx javascript = js,javascript
- 重启 VSCode，新开一个
.ts文件并编辑几秒，再查 WakaTime Dashboard 的「Languages」页，确认是否单独列出TypeScript
每天时长对不上？注意 heartbeat 间隔和离线缓存机制
WakaTime 不是实时上传，而是每 2 分钟发一次「心跳」（heartbeat），且本地会缓存最多 1000 条未发送记录。如果你关机前 5 分钟写了大量代码，又没联网，这部分时间可能延迟上传甚至丢失。
实操建议：
- 检查配置中是否误设了过长的
heartbeat_frequency（默认是120秒），不建议调低到30以下，否则触发 API 限流 - 若需保障当日数据完整，关机前留 2 分钟联网空闲，让缓存 flush 完毕；也可临时执行
wakatime-cli --sync强制上传 - Dashboard 上「Today」数据存在约 5–10 分钟延迟，别刚写完就刷新看结果
多工作区项目语言混计？用 .wakatime-project 文件隔离
比如你在同一 VSCode 窗口打开 Python 后端 + React 前端两个文件夹，WakaTime 默认按最外层文件夹名当项目名，所有代码都算进一个项目，语言时长也被合并统计。
实操建议：
- 在每个子项目根目录放一个
.wakatime-project文件，内容只写一行项目名，例如：my-react-app
或django-api
- 确保该文件无扩展名、无 BOM、UTF-8 编码，且不在
exclude列表里 - 重启 VSCode，之后该目录下所有文件都会绑定到对应项目，Dashboard 中就能分项目、分语言查看每日时长
