WakaTime插件装完没数据，首要确认Python环境、wakatime-cli是否就位及API Key是否正确配置在~/.wakatime.cfg或Sublime设置中，且必须以文件夹方式打开项目，CLI需通过终端验证可执行，控制台报错需排查401或Connection refused。

WakaTime插件装完没数据？先确认Python和CLI是否真就位

Sublime Text 的 WakaTime 插件不是纯前端组件，它依赖本地 Python 环境和 wakatime-cli 才能上报数据。很多用户卡在“装完插件→填了 API Key→没统计”，根本原因是 wakatime-cli 没跑起来。

• 终端执行 wakatime-cli --version，如果报 command not found，说明 CLI 根本没装或不在 PATH 中
• Sublime 启动时只读一次 wakatime-cli 路径，改完 PATH 或重装 CLI 后必须彻底退出 Sublime（macOS 注意菜单栏残留进程），再重开
• Windows 用户常见问题：PowerShell 执行策略阻止脚本运行；建议直接下载 wakatime-cli-windows-amd64.zip 解压到固定路径（如 C:\wakatime\），再把该路径加进系统 PATH
• Linux/macOS 自动安装脚本可能因代理或证书拦截静默失败——别信 curl 输出的 “Success”，只认 which wakatime-cli 是否返回有效路径

API Key 填错、配置文件位置不对，是“零数据”最常见原因

WakaTime 插件会尝试读取 ~/.wakatime.cfg，但 Sublime 不自动创建这个文件。填错 Key 或路径写错，会导致 401 Unauthorized 错误，控制台里能看到。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• 打开 Sublime → Preferences → Package Settings → WakaTime → Settings – User，确保 api_key 字段已填，值是从 wakatime.com/settings/api-key 复制的完整字符串（含前缀 xxxx-xxxx-xxxx-）
• 手动建 ~/.wakatime.cfg 更稳妥，内容至少包含：

  [settings]
  api_key = xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx

• 公司网络有代理？Wakatime 默认不走系统代理，必须在 ~/.wakatime.cfg 里显式写：

  [settings]
  proxy = http://your-proxy:port

• 检查 Sublime 控制台（View → Show Console），过滤关键词 wakatime，看是否有 Connection refused 或 401 日志

为什么写了代码却显示 “unknown project” 或时间归到第二天？

WakaTime 用当前打开的文件夹路径判断项目名，UTC 时间戳也常让人误判“今天没写代码”。这不是 bug，是设计行为。

• 没开文件夹直接打开单个文件（比如双击 .py 文件），Wakatime 无法推断项目，一律记为 unknown project；正确做法是用 File → Open Folder… 打开整个项目根目录
• Dashboard 的 “Today” 是 UTC 时间，非本地时区。例如北京时间 7 月 24 日 23:50 写的代码，实际算作 UTC 时间 7 月 25 日 03:50，会出现在次日统计里
• 想让项目名准确显示，可在项目根目录手动建 .wakatime-project 文件，内容就一行项目名（如 my-django-app），比靠路径解析更可靠
• Wakatime 只统计键盘输入事件（敲字、删字、粘贴），光标停留、鼠标点击、格式化、保存都不计时——这是为了区分“真实编码”和“其他操作”，不是漏统计

Sublime 启动慢、控制台报错，可能是旧版插件或 Python 版本冲突

WakaTime 插件底层调用 Python，Sublime 自带的 Python 版本（ST3 是 3.3，ST4 是 3.8）和系统 Python 混用容易出问题。

• 控制台出现 ImportError: No module named urllib.request？说明插件在用 Python 2 解析，但 Sublime 3+ 默认用 Python 3；检查插件是否为最新版，旧版可能未适配
• 看到 ModuleNotFoundError: No module named 'wakatime'？别 pip install wakatime —— Sublime 插件自带所有依赖，额外装反而冲突
• 频繁卡顿或报 plugin_host has exited unexpectedly？关闭其他插件逐一排查，WakaTime 在大量小文件切换时可能触发高频心跳，可临时在 ~/.wakatime.cfg 加：

  [settings]
  offline = true

  验证是否是网络层问题

WakaTime 在 Sublime 里真正生效的关键，从来不是“装插件”这一步，而是 CLI 是否就绪、API Key 是否落进正确配置位置、项目是否以文件夹方式打开——三者缺一不可。UTC 时间和“仅响应键盘输入”的设计逻辑，也常被当作故障，其实只是需要提前对齐预期。