WakaTime 不统计无操作时间，仅响应编辑事件；CLI 未安装或配置错误（如路径、proxy、ignore规则）是常见原因，需验证 CLI、检查配置文件、重启 VSCode 并查 ~/.wakatime.log 日志。
WakaTime 在 VSCode 里不会自动统计“打开编辑器但没敲键盘”的时间——它只在你真实输入、保存、切换文件时才计时，这是设计逻辑，不是插件故障。
插件装了但状态栏空白或显示「Connecting…」
这几乎一定是 wakatime-cli 没真正就绪。VSCode 插件只是调度层，所有心跳上报、文件解析、项目识别都由本地 wakatime-cli 完成。
- 终端执行
wakatime-cli --version，若报command not found，说明 CLI 根本没装进系统 PATH - macOS/Linux 用户常见于自动安装脚本被代理/SSL拦截中断，
curl下载失败后静默退出 - Windows 用户别信 PowerShell 安装脚本——权限和路径常错乱；直接去官网下 zip 包，解压到
C:\wakatime\，再把该路径加进系统环境变量PATH - 装完必须重启 VSCode（不是重载窗口），否则插件仍读不到 CLI
配置文件 ~/.wakatime.cfg 写错就完全不打点
wakatime-cli 默认只读用户主目录下的 ~/.wakatime.cfg（Windows 是 %USERPROFILE%\wakatime.cfg），VSCode 设置里的 wakatime.apiKey 只用于首次登录，后续全靠这个文件驱动。
- 手误高发点：
api_key = xxxxx写成apikey = xxxxx（少下划线）、开头多空格、用了中文等号、值末尾带换行符 - 敏感配置如
hidefilenames或ignore路径写错，会导致整块项目不计时，且无提示 - 建议初期清空配置，只留两行：
[settings]和api_key = xxxxx，验证通了再加其他项 - 改完配置必须关掉所有 VSCode 窗口再重开——它只在启动时读一次该文件
项目名显示「Unknown Project」或语言统计不准
WakaTime 默认用当前文件「最靠近的 Git 仓库根目录名」作为项目名，不认 VSCode 工作区文件（.code-workspace）。
- 如果项目没初始化 Git（
git init），或 .git 目录被意外删了，就会 fallback 到「Unknown Project」 - 想强制指定项目名？在项目根目录手动建
.wakatime-project文件，里面写一行纯文本项目名（不要引号、不要空格） - 语言识别依赖文件后缀（
.py、.ts），如果打开的是无后缀临时文件，或被exclude规则匹配（比如路径含node_modules），就不会计入对应语言时长 - 日志里搜
Skipping file because it matches ignore pattern就能定位是否被规则过滤
日志在哪、怎么查、为什么它不报错
WakaTime 出问题基本不弹窗、不报错，错误默认写进 ~/.wakatime.log，连 VSCode 输出面板里的 WakaTime 日志都可能被截断。
- VSCode 命令面板运行
WakaTime: Show Log，看末尾几行有没有ERROR或WARN - 更可靠的是直接翻
~/.wakatime.log：搜索Failed to run wakatime-cli、Connection timed out、Unsupported file extension - 公司网络走代理？
wakatime-cli默认不读系统代理，得在~/.wakatime.cfg里显式加proxy = http://your-proxy:8080 - 证书问题（尤其老旧 Linux）？加
ssl_verifypeer = false临时绕过（仅调试用）
最易被忽略的一点：WakaTime 的「计时」本质是「活动心跳」，不是「进程驻留」。它不监控后台 VSCode 是否开着，只响应编辑器事件。所以别指望它统计「思考时间」或「查文档时间」——那本来就不在它的设计边界里。
