WakaTime 在 PhpStorm 中需手动配置插件和 API 密钥才能自动记录编码时间；安装插件后必须填写 40 位 API Key 并启用，否则不上传数据，且需通过日志验证实际发送情况。
WakaTime 能在 PhpStorm 中自动记录编码时间，但默认不启用，需要手动配置插件和 API 密钥——没配对 wakatime-cli 或漏填 api_key，它根本不会上传数据。
安装 WakaTime 插件（PhpStorm 内置市场）
PhpStorm 2021.3 及以后版本已内置插件市场支持 WakaTime，无需手动下载 ZIP。打开 Settings → Plugins，搜索 WakaTime，点击安装并重启 IDE。
- 旧版 PhpStorm（如 2020.x）可能搜不到，需勾选右上角 Show all versions 或手动安装：访问
https://plugins.jetbrains.com/plugin/15865-wakatime下载最新.jar，再用 Install plugin from disk… 加载 - 安装后不会立刻生效，必须完成后续的 API 配置，否则状态栏只显示灰色
WakaTime字样，无计时图标 - 插件本身不包含命令行客户端
wakatime-cli，首次启动时会自动下载（约 15–30MB），需联网且允许写入~/.wakatime目录
配置 API Key（关键一步，90% 失败卡在这）
插件安装完只是“空壳”，必须绑定你个人的 WakaTime 账户才能上传数据。API Key 不是 PhpStorm 的 License Key，也不能复用其他平台账号。
- 访问
https://wakatime.com/settings/api-key登录后复制你的api_key（一串 40 位十六进制字符） - 回到 PhpStorm，打开 Settings → Tools → WakaTime，粘贴到
Api Key输入框，勾选Enable WakaTime - 保存后观察右下角状态栏：若出现绿色
✓和实时分钟数（如12m），说明已连通；若仍是灰色或弹出Invalid api key，检查是否复制了多余空格或用了旧 Key
验证是否真正在记录（别信状态栏）
状态栏显示正常 ≠ 数据已上传。WakaTime 默认每 2 分钟批量上报一次，本地日志才是最可靠的验证依据。
立即学习“PHP免费学习笔记（深入）”；
- 查看日志路径：
~/.wakatime.log（macOS / Linux）或%USERPROFILE%\.wakatime.log（Windows） - 编辑一段代码并保存，几秒后刷新日志，应看到类似
DEBUG Sending heartbeat to api.wakatime.com和INFO Response: 201的条目 - 如果只有
DEBUG Using existing config file但无发送记录，大概率是防火墙拦截、代理设置冲突，或wakatime-cli权限不足（尤其 macOS 上首次运行需同意“完全磁盘访问”） - 网页端数据延迟约 1–3 分钟，不要刚改完就刷
https://wakatime.com/dashboard
真正麻烦的是跨项目统计和排除生成文件——WakaTime 默认记录所有打开/保存的文件，node_modules、vendor、编译产物都算工时。得在 ~/.wakatime.cfg 里加 ignore 规则，否则日报里全是 webpack.config.js 的 0.3 秒。
