Neovim 插件配置：Code::Stats 统计
编写代码和刷算法题按下键盘的时候,一段段字符转化为可视化的 XP 是非常让人有成就感和动力的。Code::Stats是免费的代码统计服务，codestats.nvim则将它接入 Neovim。需要说明的是：官方暂无 Neovim 插件，这个项目由开源大佬维护仓库链接。
1. 前置准备
安装前请确认以下条件：
- Neovim及其基础环境。
- Curl：用于向服务器发送统计数据。
- Code::Stats 账户：注册后在 Machine Page 获取API Key。
Machine Page
2. 插件安装与配置
推荐使用Lazy.nvim管理插件。为保持配置整洁，建议在插件目录下新建codestats.lua：
- macOS/Linux:
~/.config/nvim/lua/plugins/ - Windows:
C:\Users\<用户名>\.config\nvim\lua\plugins\
若你已使用 LazyVim，直接放入上述路径即可；否则可先克隆官方仓库：
仓库链接
核心配置代码
在lua/plugins/下创建codestats.lua，填入以下配置（注意必须以return开头）：
return{'liljaylj/codestats.nvim',dependencies={'nvim-lua/plenary.nvim'},-- 必需依赖，提供异步处理能力event={'TextChanged','InsertEnter'},-- 懒加载：仅在输入文字或进入插入模式时启动cmd={'CodeStatsXpSend','CodeStatsProfileUpdate'},-- 命令触发加载config=function()require('codestats').setup{username='<你的用户名>',-- 用于获取个人资料数据(必须改)base_url='https://codestats.net',api_key='<你的 API key>',-- 你的个人 API 密钥(必须改)send_on_exit=true,-- 退出 nvim 时自动发送 XPsend_on_timer=true,-- 开启定时发送功能timer_interval=60000,-- 建议设置为 60000ms (1分钟)，防止对服务器造成压力curl_timeout=5,-- 请求超时时间}end,}3. 进阶：集成到状态栏
如果你想实时看到自己的 XP 或等级，可以将其集成到状态栏中。以常用的Lualine为例：
localxp=function()-- 获取当前缓冲区对应语言的 XPreturnrequire('codestats').get_xp(0)endrequire('lualine').setup{sections={lualine_x={'filetype',{xp,fmt=function(s)returnsand(s~='0'ornil)ands..'xp'end},},},}4. 常用交互命令
安装完成后，你可以通过以下命令手动管理数据：
:CodeStatsXpSend：立即手动发送当前的 XP 统计。:CodeStatsProfileUpdate：手动从服务器拉取最新的个人资料数据。
5. 常见故障排除
1. 报错Failed to load ...: return expected
原因：在lua/plugins/下的文件没有使用return { ... }结构。
解决：确保你的插件配置文件以return开头，将配置表传递给 Lazy.nvim。
2. 插件克隆失败 (Connection was reset)
原因：通常是网络环境导致无法正常访问 GitHub。
解决：
- 在 Neovim 中输入
:Lazy，选中插件并按R键重试。 - 检查你的终端是否配置了正确的网络代理。
3.plenary.nvim依赖问题
codestats.nvim依赖plenary.nvim来处理异步任务（如plenary.job）。只要在dependencies中声明，Lazy.nvim 会自动为你安装，无需手动干预。
6. 结语
希望对你有帮助,现在就打开你的 Neovim，开始累积你的编程经验值吧！
