该技能面向 Neovim/LazyVim 配置调试,核心是通过假设与验证系统化定位问题,而非逐条检查清单。适用症状包括:Lua 报错(如 E5108)、按键无反应、插件功能缺失或未加载、启动缓慢或卡顿、颜色或界面元素异常。
调试思路:先观察症状,再形成假设,优先测试最可能的原因,通过二分缩小范围,最后确认根因并验证修复。它主张在向用户提问前,先尝试用无头模式或检查配置文件自行收集信息,仅在需要交互反馈时才询问用户。
可用无头命令示例:检查插件是否安装 nvim --headless -c "lua print(pcall(require, 'PLUGIN_NAME'))" -c "qa" 2>&1;查看配置值 nvim --headless -c "lua print(vim.inspect(CONFIG_PATH))" -c "qa" 2>&1;检查函数是否存在、查看 leader 与 localleader 设置;以及查看 LazyVim extras:cat ~/.config/nvim/lazyvim.json 2>/dev/null || echo "Not a LazyVim config"。
其决策框架会区分能否自行复现、问题是否间歇、此前是否正常、影响范围是否孤立,据此选择排查方向。技能还引用诊断流程图、错误模式、信息收集和插件专项等文档,覆盖 which-key、LSP、telescope 等插件的调试。
限制方面:资料未提供安装方式、收费信息、支持平台或具体版本要求;实际效果取决于具体配置与环境。