
copilot.el
在 Emacs 里直接白嫖 Copilot 补全,不用换编辑器
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-23 · 当前星标 ★ 2330
使用教程
环境要求
- Emacs 27 或更高版本
- 可用的 GitHub Copilot 账号(2025 年起提供免费额度)
- 配置 MELPA 包源(editorconfig、jsonrpc、compat、track-changes 会自动安装)
- 仅在改用 npm 安装语言服务器时需要 Node.js 22+;使用原生二进制时无需 Node.js
安装与启动步骤
-
1写入安装配置
把 use-package 片段加入 Emacs 配置文件,保存后重启 Emacs 或 eval-buffer 使其生效;依赖会从 MELPA 自动安装
(use-package copilot :ensure t :hook (prog-mode . copilot-mode) :bind (:map copilot-completion-map ("" . copilot-accept-completion) ("TAB" . copilot-accept-completion) ("C- " . copilot-accept-completion-by-word) ("C-TAB" . copilot-accept-completion-by-word) ("C-n" . copilot-next-completion) ("C-p" . copilot-previous-completion))) -
2安装语言服务器
在 Emacs 中执行该命令;没有 npm 时会自动下载并安装对应平台的原生二进制,无需 Node.js
M-x copilot-install-server -
3登录 Copilot 账号
执行后按提示完成 GitHub Copilot 授权登录,登录成功后才可获得官方补全服务
M-x copilot-login -
4使用补全功能
在 prog-mode 缓冲区输入代码会显示灰色幽灵文本;Tab 接受全部,C-Tab 按词接受,C-n/C-p 切换候选
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
copilot-node-executable | 否 | 指定 Node.js 22+ 可执行文件路径,供服务器和安装命令使用 | /usr/local/bin/node |
copilot-completion-map | 否 | 补全键位映射,用于绑定接受、按词接受和切换候选 | (" |
如何确认成功
打开 prog-mode 文件并输入代码,缓冲区出现灰色幽灵补全文本,按 Tab 可接受即表示成功。
常见问题
Q:必须安装 Node.js 吗?
A:不必。npm 不可用时 copilot-install-server 会自动下载原生二进制;只有你想通过 npm 安装时才需要 Node.js 22+。
Q:没有 Copilot 订阅能用吗?
A:需要拥有 GitHub Copilot 访问权限,官方在 2025 年初推出了免费额度,登录后按账号权限使用。
Q:补全不出现怎么办?
A:确认 copilot-mode 已启用、已执行 copilot-login 登录成功,并检查光标位置是否处于可补全的代码上下文。
Q:node 版本过旧会怎样?
A:若 PATH 中首个 node 低于 22,可把 copilot-node-executable 指向新版 node,服务器与安装命令都会使用它。
注意事项
- copilot.el 是非官方插件,需自行拥有 GitHub Copilot 服务访问权限。
- 插件通过 jsonrpc.el 直连语言服务器,全局共享一个服务器进程,不经过 eglot 等 LSP 客户端。
- 运行单元测试需安装 eask,命令为 eask test buttercup。
核心亮点
- 补全以内联幽灵文本呈现,接受/拒绝/按词接受等操作贴合 Emacs 键位习惯
- 支持手动触发与自动补全开关,可调触发延迟,适配不同编辑节奏
- 纯 Emacs Lisp 实现,安装配置轻量,不依赖外部语言运行时
不足之处
- 依赖 GitHub Copilot 官方服务与账号授权,无法离线使用
- 作为非官方插件,Copilot 接口变动时可能滞后修复
适用场景
- Emacs 重度用户写业务代码时获得行内 AI 补全
- 在远程服务器上用终端 Emacs 开发时保持补全体验
- 维护老项目时用补全快速写出重复样板代码
替代项目
company-mode、lsp-mode
上一篇:coucou
下一篇:LeanCopilot
同类项目推荐
ai-code-fusion
开源
一键把整个代码仓库打包成单文件,喂给 AI 更高效
Desktop app to process repository content into one file
code_puppy
开源
说句话,AI 代理自己动手把代码写完
Agentic AI for writing code
awesome-vibe-coding
开源
一站式掌握AI协作编程,从入门到实践。
A curated list of vibe coding references, collaborating with AI to write code.
cockpit-tools
开源
一个面板管住所有 AI IDE 账号,切换监控自动唤醒
通用 AI IDE 账号管理工具:支持 Antigravity / Codex / GitHub Copilot / Windsurf / Kir···
aver
开源
让 AI 写的代码,每一行都能被审计和信任
Aver is a programming language for auditable AI-written code
XRobot
开源
配置一下,自动生成机器人底层代码
XRobot Auto Code Generation Toolkit
oh-my-openagent
开源
让 Codex 和 OpenCode 在大型代码库中省 token 又听话
OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph ···
lattice
开源
给 AI 编程助手装上工程纪律,让代码更规范
Install engineering discipline into any AI coding assistant. Composable skills for d···
Waza
开源
把工程习惯变成 AI 能直接执行的技能
Engineering habits you already know, turned into skills AI assistants like Claude Co···