wakatime 在 sublime text 中需满足三条件才生效：先装 package control，再确保系统已安装 python（st3 要求 urllib.request 支持），最后手动在 wakatime.sublime-settings 中填入 api key；缺一不可，否则无法上报数据。
装完就能用，但不配 Python 或漏填 API Key 就根本不会上报——WakaTime 在 Sublime Text 里不是“安装即生效”，而是“装完+环境齐+密钥对=开始记录”。
Sublime Text 必须先装 Package Control 才能装 WakaTime
WakaTime 官方只通过 Package Control 分发，没这玩意儿，ctrl+shift+p 搜不到插件。别跳过这步直接搜 WakaTime，会白忙。
- 用
ctrl+`（反引号）调出 Sublime 控制台，粘贴对应版本的安装代码（ST3 用urllib.request版本，别错用 ST2 的urllib2） - 执行后没报错、也没提示“Please restart”，说明已成功；如果卡住或报
ImportError: No module named urllib.request，说明你用的是 ST2，得换对应代码 - 重启 Sublime，再按
ctrl+shift+p输入Package Control: Install Package，能弹出列表才算真正就位
WakaTime 插件依赖本地 Python 环境
它不是纯 Python 插件，而是一个调用系统 Python 的代理层——没 Python，WakaTime 进程压根起不来，状态栏不会显示编码时间，日志里也找不到 wakatime-cli 启动痕迹。
- Windows 用户推荐装 Python 3.8–3.12（太新如 3.13 可能暂不兼容），勾选
Add Python to PATH - macOS 或 Linux 下确认
python3命令可用，且which python3返回路径不为空；如果用 pyenv，确保当前 shell 能访问到该版本 - 装完后，在 Sublime 控制台运行
import sys; print(sys.version)验证 Python 可用性，避免插件静默失败
API Key 必须手动填进 WakaTime.sublime-settings
Sublime 不像 VS Code 那样自动弹窗要 Key，也不读 ~/.wakatime.cfg——它只认自己插件目录下的配置文件，填错位置等于没填。
- 按
ctrl+shift+p输入Preferences: Package Settings → WakaTime → Settings，打开用户配置文件 - 在里面写入：
{ "api_key": "your_api_key_here" }注意是双引号包裹的字符串，不是注释掉的示例值 - 保存后观察状态栏右下角：几秒内出现
0h 0m或具体编码时长，说明已连上服务器；若一直显示WakaTime: Not Connected，大概率是 Key 错了或网络被拦截
每日代码时间百分比在官网看，Sublime 里不计算
插件只负责采集和上报原始事件（文件打开、保存、光标停留等），所有统计逻辑（比如“今天写了 4.2 小时，占全天电脑使用 63%”）全由 WakaTime 服务端算好，前端只展示结果。
- 登录 https://www.php.cn/link/a6fa45504565dc0928efc8807db66487，默认首页就是今日概览，含「Coding Activity」饼图和小时数
- 百分比基于你设备上所有启用 WakaTime 的工具（浏览器、IDE、设计软件）汇总数据，不是单指 Sublime；如果只在 Sublime 用，那它几乎就是 100%
- 免费账户只保留最近 2 周数据，想查更早的“某天占比”，得开 Pro 订阅——这点容易忽略，等真要用历史对比才发现没了
