Waka Time插件无数据需先检查API密钥配置和网络代理；周报依赖服务端生成与邮件推送，需确认邮箱验证及订阅设置；项目名异常可用.wakatime-project文件修正；导出数据须调用官方REST API。
Waka Time插件装了但没数据？先检查API密钥和网络代理
Waka Time周报不会自动出现，核心前提是插件必须成功上报数据。常见现象是安装插件后VSCode右下角显示 WakaTime: Initializing... 却一直卡住，或几天后打开 wakatime.com/dashboard 仍无任何时间记录。
根本原因通常是API密钥未配置，或本地网络无法直连 api.wakatime.com（尤其在国内办公环境）。
- 打开VSCode命令面板（
Ctrl+Shift+P/Cmd+Shift+P），执行WakaTime: Set API Key，粘贴从wakatime.com/settings/api-key复制的密钥 - 若公司用代理，需在VSCode设置中添加：
"wakatime.proxy": "http://127.0.0.1:10809"（替换为你实际的代理地址和端口） - 插件日志默认写入
~/.wakatime.log（macOS/Linux）或%USERPROFILE%\.wakatime.log（Windows），出问题时直接查它，看是否有ConnectionError或Invalid API Key
周报邮件收不到？确认wakatime.com账户的订阅状态和邮箱权限
Waka Time周报（Weekly Summary）是服务端生成并邮件推送的，不是VSCode本地功能。即使插件运行正常，也可能因账户设置缺失导致收不到邮件。
- 登录
wakatime.com/dashboard→ 点击右上角头像 →Settings→ 检查Weekly Summary Email是否开启 - 确保邮箱已验证：若注册后未点击验证链接，周报会被系统拦截
- 检查垃圾邮件箱；部分企业邮箱（如腾讯企业邮、阿里云邮箱）会将
@wakatime.com发件人标记为“外部”，需手动设为信任 - 免费账户默认只保留最近2周的数据，超过即被清理——周报里看不到更早的项目统计属正常行为
项目名显示为“Unknown”或路径太长？靠 .wakatime-project 文件精准归类
Waka Time默认按文件路径推断项目名，遇到单文件编辑、符号链接、远程开发（SSH/WSL）等情况，常把项目识别成 Unknown 或截断成 /home/u.../pr.../src，导致周报里的“Top Projects”统计失真。
解决方式是在项目根目录手动创建 .wakatime-project 文件，内容就是你想要的项目名：
my-frontend-app
这个文件会被递归识别，子目录下的所有文件都归属该项目。注意：
- 文件必须是纯文本，无扩展名，无空格或特殊字符（推荐用短横线分隔）
- 如果项目用了Git，也可以用
.git目录自动识别，但遇到子模块或非标准工作区时不如显式配置可靠 - VSCode多根工作区（multi-root workspace）下，每个文件夹需单独放一个
.wakatime-project，否则可能混进同一个项目名
想导出CSV或对接其他工具？直接调用Waka Time REST API而非依赖插件
VSCode插件本身不提供导出功能，所有历史数据、详细语言占比、项目耗时明细，都得通过Waka Time官方API获取。比如要拉取上周编码时间的完整记录：
用curl发请求（需替换你的API密钥）：
curl -X GET \ 'https://api.wakatime.com/v1/users/current/summaries?start=last_7_days&end=last_day' \ -H 'Authorization: Basic YOUR_BASE64_ENCODED_API_KEY'
关键点：
- API密钥需Base64编码（
echo -n 'your-api-key' | base64），不能直接明文传 - 时间范围参数用
start和end，支持last_7_days、last_30_days，也支持具体日期如2024-05-01 - 返回JSON里
data[0].grand_total.total_seconds是总秒数，data[0].languages是语言明细，data[0].projects是项目明细 - 免费账户限速为每分钟10次请求，高频调用建议加缓存或错峰
真正难的不是配插件，而是让项目名对得上、时间范围算得准、API调用不被限流——这些细节漏掉一个，周报就只是个好看但不准的数字快照。
