WakaTime 是 VSCode 中自动追踪真实编码时间的插件，仅统计敲代码、保存、调试等活跃行为，过滤发呆等非编码时间；安装后登录即可自动采集，Dashboard 显示时长、项目、语言、编辑器状态等核心指标，并支持隐私设置与自定义配置。
WakaTime 是 VSCode 中最实用的编程时间追踪插件之一，它不靠手动打卡，而是自动记录你真实编码行为——比如敲代码、保存文件、切换标签页、甚至调试时的停留时间。关键在于它只统计“活跃编码”时段，过滤掉发呆、查文档、回消息这些非编码时间，数据才真正反映你的生产力。
安装与首次配置很简单
在 VSCode 扩展市场搜 WakaTime，点击安装即可。重启后会提示你登录或注册 WakaTime 账户（支持 GitHub 快速授权）。登录成功后，插件自动开始采集数据，无需额外设置。注意：首次运行会生成本地 API key 并安全存储在系统凭据管理器中，不用手输密钥。
看懂 Dashboard 里的核心指标
打开 wakatime.com/dashboard，你会看到几个关键信息：
- Today / This Week / This Month：实时显示当前周期的编码总时长，精确到分钟
- Projects：按项目自动归类，识别依据是文件路径中的文件夹名（可手动重命名项目）
- Languages：统计各语言实际编码占比，比如“Python 42%、TypeScript 31%”，比“打开多少个 .py 文件”更真实
- Editors：确认 VSCode 是否正常上报（状态为 “Online” 即表示插件工作正常）
让数据真正有用的小技巧
默认统计已经很准，但稍加调整能让它更贴合你的习惯：
- 在 VSCode 设置中搜索 wakatime，勾选 Hide File Names 避免敏感项目名上传（适合外包或私有开发）
- 用 Project Name Override 功能，在项目根目录下建
.wakatime-project文件，写入自定义项目名，解决多仓库共用同一父目录的问题 - 如果某类文件（如 Markdown 或配置文件）被误计入编码时间，可在
.wakatime.cfg中用exclude规则过滤，例如：exclude = ^/tmp/|.*\.md$
不只是“看了爽”，还能帮你改进习惯
连续记录一两周后，你会自然发现一些模式：比如下午三点后编码时长骤降、某个项目长期占时却进展缓慢、或是 JavaScript 文件修改频繁但有效产出少。这时候数据就不是数字游戏，而是反馈闭环的起点——你可以据此调整日程、拆解任务、甚至重新评估技术选型。WakaTime 不催你加班，但它诚实地告诉你：时间花在哪，结果就在哪。
基本上就这些。不复杂，但容易忽略细节。
