code time需完成账户绑定、网络连通、语言识别三重校验才生成有效指标；未登录或api不通则面板空白，仅本地记录事件；右下角无“code time: online”提示即统计引擎未启动。
Code Time 不是“安装即出报告”的全自动工具，它必须完成账户绑定、网络连通、语言识别三重校验后，才开始生成有效指标；没登录或 API 连不通，面板永远空白。
插件安装后必须 Sign in 才能触发指标计算
未登录状态下，Code Time 只在本地记录原始事件（如按键、保存），但不会上传、不会建模、不会生成任何图表。右下角状态栏不显示 Code Time: Online，就等于没启动统计引擎。
- 安装后务必通过命令面板执行
CodeTime: Sign In，不能只点通知里的 Sign in——部分版本该通知会失效 - 推荐用 GitHub 登录：授权时勾选
public_repo和read:user，否则后续语言热力图可能缺失仓库上下文 - 登录成功后，检查用户数据目录：
~/.codetime/config.json中应有非空的user_id和api_key字段
API Status offline 是指标空白最常见原因
CodeTime: Show Diagnostics 输出里 API Status 显示 offline 或超时，代表插件根本没连上 api.software.com，所有本地数据都卡在队列里发不出去。
- 先在终端运行
curl -I https://api.software.com/v1/ping，确认返回HTTP/2 200；若失败，说明是网络层拦截 - 公司网络常因代理或防火墙屏蔽该域名，临时切手机热点可快速验证是否为环境问题
- hosts 文件若含
127.0.0.1 api.software.com类条目，需手动删掉——这类配置常被旧版安全软件注入
文件没被识别为代码，就不会计入编码时长
Code Time 统计的是“编程行为”，不是“打开文件行为”。一个 .txt 文件即使写满 Python 语法，只要 VS Code 将其语言模式设为 Plain Text，它就完全不计时。
- 打开文件后看右下角语言标识（如
Python、JavaScript），若显示Plain Text，点击它 → 选择正确语言模式 - 无扩展名的脚本需手动设置：按
Cmd+Shift+P→ 输入Change Language Mode→ 选对应语言 - 自定义后缀（如
.mylang）需在settings.json中配"files.associations": {"*.mylang": "javascript"}
Sync Now 不等于立即刷新 Dashboard
执行 CodeTime: Sync Now 后右下角提示成功，不代表 Dashboard 面板立刻更新——它仍依赖后台定时拉取聚合结果，首次同步后通常要等 2–5 分钟。
- 确保已打开至少一个有效代码文件（如
.py），且编辑过几行再触发同步，否则上报数据为空 - Dashboard 加载失败时，别反复点
CodeTime: Show Dashboard，先关掉所有标签页再重启 VS Code - 若持续空白，删除
~/.codetime/db.sqlite3并重启，插件会重建数据库并从当前时间重新采集
真正卡住的地方往往不在安装步骤，而在登录后的静默失败：API 调不通、文件类型错标、本地数据库损坏——这三类问题占指标无法生成案例的 90% 以上，且都不会报红错，只会安静地不显示任何数据。
