copilot.lua

环境要求

• NeoVim 0.11.0 或更高版本
• NodeJS v22 或更高版本
• 已安装插件管理器（如 packer.nvim）
• （可选）copilot-lsp 用于 NES 功能

安装与启动步骤

1. 1确认环境版本

   先检查 NeoVim 与 NodeJS 版本，低于 0.11.0 / v22 需要先升级，否则 Copilot 服务无法运行。

   nvim --version
   node -v

   复制

2. 2安装插件

   用你习惯的插件管理器添加 zbirenbaum/copilot.lua；需要 NES 功能时再加上 copilot-lsp 依赖。

   use { "zbirenbaum/copilot.lua",
     requires = {
       "copilotlsp-nvim/copilot-lsp", -- (optional) for NES functionality
     },
   }

   复制

3. 3配置懒加载

   Copilot 服务启动需要时间，README 建议懒加载：以 Copilot 命令和 InsertEnter 事件触发，避免拖慢启动。

   use {
     "zbirenbaum/copilot.lua",
     requires = {
       "copilotlsp-nvim/copilot-lsp", -- (optional) for NES functionality
     },
     cmd = "Copilot",
     event = "InsertEnter",
     config = function()
       require("copilot").setup({})
     end,
   }

   复制

4. 4调用 setup 启动

   必须执行 require("copilot").setup(options) 才会启动 Copilot；不传参数即使用默认配置。

   require("copilot").setup({})

   复制

5. 5按需自定义配置

   在 setup 的 table 中覆盖默认项，例如面板、建议键位、模型、Node 路径等，再重启 Neovim 生效。

   require('copilot').setup({
     panel = { enabled = true },
     suggestion = {
       enabled = true,
       auto_trigger = false,
       keymap = { accept = "<M-l>" },
     },
     copilot_node_command = 'node',
   })

   复制

关键配置

如何确认成功

重启 Neovim 后执行 :Copilot 命令，或进入插入模式看到灰色虚拟文本建议即为生效。

常见问题

注意事项

• 必须调用 require("copilot").setup(options) 才会启动 Copilot，未调用则不生效。
• 认证方式见 README 的 Authentication 一节；使用替代 GitHub 实例时通过 auth_provider_url 指定。
• 不传任何参数时使用 README 中列出的默认配置。
• copilot-lsp 为可选依赖，仅在需要 NES 功能时安装。