WakaTime插件统计失效需依次检查：一、确认插件已启用并完成初始化；二、配置有效API密钥；三、安装并验证wakatime-cli版本≥v1.60.0；四、排查工作区是否被忽略；五、检查代理与防火墙限制。

如果您在 Visual Studio Code 中安装了 WakaTime 插件，但发现编程时间未被正常统计，则可能是由于插件未正确配置、API 密钥缺失或网络连接异常。以下是解决此问题的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、检查 WakaTime 插件是否启用并完成初始化

WakaTime 插件需在首次启动时完成本地日志监听器初始化，并建立与 WakaTime 服务器的通信通道。若插件处于禁用状态或初始化失败，将无法捕获编辑行为。

1、打开 VSCode，点击左侧扩展图标（或按 Cmd+Shift+X）。

2、在搜索框中输入 WakaTime，确认已安装且右侧显示“已启用”按钮。

3、按下 Cmd+Shift+P 打开命令面板，输入 WakaTime: Show Dashboard 并回车；若弹出空白页或报错“API key not found”，说明初始化未完成。

二、验证并配置 WakaTime API 密钥

WakaTime 依赖用户专属 API 密钥进行身份认证与数据上传。密钥缺失、格式错误或权限失效均会导致统计中断。

1、访问 https://wakatime.com/settings/api-key，页面顶部显示的密钥（以 d1a... 开头的长字符串）。

2、在 VSCode 中按下 Cmd+Shift+P，输入 Preferences: Open Settings (JSON) 并回车。

3、在 settings.json 文件末尾的花括号内添加如下行（注意前一行末尾补上逗号）：

"wakatime.apiKey": "d1a..."

三、确认 WakaTime CLI 是否成功安装并可执行

WakaTime 插件依赖本地 CLI 工具解析编辑器事件并发送至服务端。若 CLI 未安装、版本过旧或被系统拦截，统计功能将完全静默。

1、打开终端，执行命令：which wakatime-cli；若返回空行，说明 CLI 未安装。

2、执行 curl -fsSL https://raw.githubusercontent.com/wakatime/wakatime-cli/master/scripts/install.sh | sh 完成自动安装。

3、再次运行 wakatime-cli --version，确认输出版本号不低于 v1.60.0。

四、检查 VSCode 工作区是否被 WakaTime 忽略

WakaTime 默认跳过特定路径模式（如 node_modules、.git、临时文件夹），若当前项目位于被忽略路径下，编辑行为不会被记录。

1、在 VSCode 中打开命令面板（Cmd+Shift+P），输入 WakaTime: Show Log 并回车。

2、滚动日志末尾，查找类似 Skipping file because it matches ignore pattern 的提示行。

3、如需取消忽略，进入设置 JSON，添加配置项："wakatime.ignore": ["!my-project/src"]（替换为实际路径）。

五、排查代理与防火墙限制

WakaTime CLI 默认通过 HTTPS 向 api.wakatime.com 提交数据。若企业网络启用严格代理或 macOS 防火墙阻止后台进程联网，上传将失败。

1、在终端执行：curl -I https://api.wakatime.com/api/v1/users/current，观察是否返回 HTTP 200 状态码。

2、若超时或拒绝连接，在 VSCode 设置 JSON 中添加代理配置："wakatime.proxy": "https://your-proxy:8080"。

3、前往“系统设置 > 网络 > 防火墙 > 选项”，确认 wakatime-cli 进程具有“传入连接”权限。