为什么不用 LazyVim？#

• 当前配置已覆盖 LazyVim 核心插件的 90%+
• 有 Claude Code，不需要 avante.nvim / CodeCompanion
• 前端开发只需要 vtsls，LazyVim 的多语言优势用不上
• 自己写的配置，每一行都理解，调试成本低

为什么不用 vim.pack？#

• Neovim 0.12 内置，但生态不成熟
• 首次安装插件时 headless 模式下经常超时
• lazy.nvim 支持懒加载、自动更新、依赖管理

为什么用 nvim-cmp 不用 blink.cmp？#

• blink.cmp 确实更快，但 nvim-cmp 生态更成熟
• 当前配置没有遇到窗口重叠问题
• 后续可无缝切换

1. vim.pack API 不一致#

vim.pack.add 需要完整 GitHub URL（https://github.com/...），不接受短格式。首次 headless 安装经常超时。解决方案：手动 git clone 到 ~/.local/share/nvim/site/pack/core/opt/，然后 vim.pack.add 注册。

2. nvim-lspconfig 在 0.12 被废弃#

报错：The require('lspconfig') "framework" is deprecated。解决：改用 vim.lsp.config('vtsls', {...}) + vim.lsp.start() 原生 API。

3. snacks.nvim 重复 setup#

lazy.nvim 已自动加载 snacks，手动 require("snacks").setup() 报错 “already setup”。解决：只配快捷键，不调用 setup。

4. tree-sitter 语法树下载超时#

11 个语言包下载，HTTP/2 经常报 curl: (16) Error in the HTTP2 framing layer。解决：

1
git config --global http.version HTTP/1.1

然后重新安装。

5. macism 无法通过 brew 安装#

macOS 上没有现成的 cask。解决：从源码编译：

1
git clone --depth 1 https://github.com/laishulu/macism.git
2
cd macism_src && make
3
mv macism /opt/homebrew/bin/macism

6. 语法高亮全灰#

主题生效了但代码全灰白——tree-sitter 语法解析器没装好。解决：

1
-- 在 nvim 中执行
2
require('nvim-treesitter.install').install({'typescript','tsx','vue','javascript','json','html','css','markdown','markdown_inline','lua','bash'})

7. 中文输入法切换#

退出插入模式后输入法不会自动切回英文。解决：安装 macism + im-select.nvim，配置 default_ime = "com.apple.keylayout.ABC"。