WakaTime 插件需通过官方Package Control安装，配置api_key后排查网络、代理、权限及日志；项目忽略用.exclude正则和.wakatime-project双控；数据管理在网页端，导出CSV或删除时间段数据。
WakaTime 插件在 Sublime Text 里怎么装？
直接装官方插件就行，别走第三方渠道——WakaTime 官方维护的 Package Control 插件源最稳，其他方式容易装错版本或漏依赖。
- 确保已安装
Package Control（没装就先去官网复制安装命令，粘贴进 Sublime 的Ctrl+`控制台执行） - 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Package Control: Install Package回车 - 搜
WakaTime，点它安装；完成后会自动弹出配置提示（没弹？手动建~/.wakatime.cfg） - 必须填
api_key：去wakatime.com/dashboard/api-key复制，粘到配置文件里对应位置，别手输
为什么改了代码不统计？常见断连原因
不是插件坏了，大概率是网络、权限或路径卡住了。WakaTime 默认每 2 分钟批量上报一次，本地日志才是第一排查依据。
- 检查
~/.wakatime.log（macOS/Linux）或%USERPROFILE%.wakatime.log（Windows），搜ERROR或Connection refused - 公司防火墙/代理常拦截
https://api.wakatime.com，需在.wakatime.cfg加proxy = http://your-proxy:port - Sublime 用 portable 模式或绿色版时，
WakaTime可能读不到用户目录下的配置，建议把.wakatime.cfg放到 Sublime 安装根目录同级 - 某些杀毒软件（如 Windows Defender 实时防护）会静默阻止
wakatime-cli进程启动，临时禁用试试
如何让 WakaTime 统计特定项目但忽略 node_modules？
靠 .wakatime-project 文件 + exclude 配置双控，光靠项目根目录放文件不够，还得告诉它哪些路径不许碰。
- 在项目根目录新建
.wakatime-project，内容写项目名（比如my-react-app），WakaTime 就会把所有子文件归到这项目下 - 在
.wakatime.cfg全局配置里加：exclude = ^/node_modules/|^/venv/|.*\.log$—— 注意用|分隔多个正则，开头的^表示绝对路径匹配 - 排除路径对大小写敏感（Windows 默认不敏感，但 WakaTime CLI 内部按 Unix 规则处理），稳妥起见写全小写
node_modules - 如果用了符号链接（symlink）进项目，WakaTime 默认不跟踪，需额外加配置
follow_symlinks = true
数据导出和隐私控制在哪设？
所有数据管理动作都在网页端做，Sublime 插件本身不存原始时长或文件路径——它只传哈希后的文件名、语言类型、编辑时长给服务器。
- 登录
wakatime.com/dashboard→Settings→Privacy，可关掉「Show file names」，这样周报里只显示index.js而非完整路径/Users/alice/project/src/index.js - 导出历史数据点：进
Reports→Export Data→ 选日期范围，下载的是 CSV，字段含entity（文件名）、language、project、duration（秒） - 删数据只能整块删：在
Settings→Delete Data选时间段，删完不可逆；想留某项目数据？先导出再删，别图省事全清
真正麻烦的是跨设备时间合并逻辑——WakaTime 按本地系统时间戳记事件，如果你笔记本和台式机时区/时间不准，同一段编码会被拆成两段，且无法后期修正。校准系统时间比调配置重要得多。
