3. 核心选项
核心默认值在 coxn.editor/default-options。全部用 (set-option! 键 值) 设置。
3.1 编辑与缩进
| 选项 | 默认 | 说明 |
|---|
:tab-width | 8 | Tab 字符的显示宽度(照 Emacs)。EditorConfig 的 tab_width / file-local 可按 buffer 覆盖 |
:indent-offset | 4 | 每级缩进的空格数。语言主模式可自带默认(Clojure / Lisp 系是 2);EditorConfig / file-local 可按 buffer 覆盖 |
:fill-column | 70 | M-q(fill-paragraph)与 auto-fill 的行宽(Emacs 默认 70) |
:electric-pair | false | 自动补全括号 / 引号(M-x electric-pair-mode 开关;Emacs 默认关) |
:show-paren | true | 高亮匹配的括号(show-paren-mode,Emacs 28 起默认开) |
:line-move-visual | true | C-n / C-p 按屏幕行走(长行折行时逐屏幕行;Emacs 默认) |
:scroll-margin | 0 | 预留(Emacs scroll-margin 的对应项;当前版本尚未消费) |
3.2 界面与显示
| 选项 | 默认 | 说明 |
|---|
:display-line-numbers | false | 行号。M-x display-line-numbers-mode(当前 buffer)/ global-display-line-numbers-mode(全局) |
:mouse | true | 终端鼠标(xterm-mouse-mode)。开着时 Shift+拖动仍是终端自己的选择;M-x xterm-mouse-mode 开关 |
:extended-keys | true | kitty 键盘协议 / modifyOtherKeys:让终端送得出 C-; C-? C-S-a 等组合键 |
:which-key-delay-ms | 500 | 按下前缀键后多久弹出 which-key 提示 |
:tab-bar-mode | false | 顶部标签栏(M-x tab-bar-mode 开关) |
:minibuffer-display | :bottom | minibuffer(M-x / C-x C-f 等)位置::bottom 底部 helm 样式(spacemacs 手感);:popup 屏幕中央浮框(vertico-posframe 手感) |
:eldoc-display | :echo | 自动函数提示画在哪::echo 最底下一行(不打扰编辑);:popup 自动弹浮框。M-m t E 切换。M-m h g 的主动查看小框不受此项影响 |
:color-depth | :auto | 色深::auto 按终端自动探测(COLORTERM / TERM / Windows Terminal);24 强制真彩;8 强制 256 色档(用主题里人挑的降级色) |
:text-scale | 1.0 | 文字缩放倍数(Emacs text-scale-mode):C-x C-+ / C-x C-= 放大、C-x C-- 缩小、C-x C-0 复位,每档 ×1.2,范围 0.2–8.0,C-u 3 C-x C-+ 一次 3 档。GUI 按新字号重算行列;TUI 字号由终端决定,只记倍数。注意:与 Emacs 不同,这里是全局的 |
3.3 补全
| 选项 | 默认 | 说明 |
|---|
:completion-auto | true | 打字停下自动弹补全(corfu 手感)。M-m t a 开关 |
:completion-auto-delay-ms | 150 | 停下多久后自动弹 |
:completion-auto-prefix | 2 | 符号至少打够几个字符才自动弹(. -> :: 这类触发字符不受此限) |
:completion-sync-wait-ms | 300 | 补全请求发出后先同步等这么久:来源都回来了就当场出结果,否则转异步浮框(不超过 :lsp-timeout-ms) |
3.4 文件、自动保存与持久化
| 选项 | 默认 | 说明 |
|---|
:auto-revert | true | buffer 没改过、文件在外面被改了 ⇒ 自动重读 |
:auto-save | true | 自动把改过的 buffer 存一份副本(不碰原文件) |
:auto-save-interval | 300 | 每多少次按键触发一次自动保存 |
:auto-save-timeout-ms | 30000 | 空闲多少毫秒触发一次自动保存 |
:auto-save-dir | <cache>/auto-save | 自动保存目录;文件名照 Emacs 编码(/#路径编码#) |
:make-backup-files | true | 每次会话第一次存盘前,把原文件复制一份备份 |
:backup-dir | <cache>/backup | 备份目录(文件名 路径编码~) |
:save-place | true | 记住每个文件的 point / 窗口位置,重开恢复(文件改动后靠上下文找回) |
:save-place-file | <config>/save-place.edn | save-place 的存储文件 |
:bookmark-file | <config>/bookmarks.edn | 书签(C-x r m / C-x r b)的存储文件 |
:projects-file | <config>/projects.edn | 认识的项目清单的存储文件(M-x project-forget-project 等用) |
<config> / <cache> 见 §15。
3.5 GUI 字体(仅 coxn-gui;TUI 忽略这些)
默认全部 nil = 跟系统:主字体取系统等宽,CJK / 符号 / emoji 走系统 fontconfig 回退 (CJK 拿等宽黑体保双格对齐)。覆盖时给优先级列表,取第一个已安装的(照 spacemacs my-fonts.el):
| 选项 | 默认 | 说明 |
|---|
:gui-font | nil | 主字体,如 ["JetBrains Mono" "Fira Code"] |
:gui-font-size | nil(= 14) | 字号,单位 sp(桌面端 ≈ px;照 Emacs :size),如 14 |
:gui-font-cjk | nil | 全角 / 汉字字体,如 ["Noto Sans Mono CJK SC"] |
:gui-font-symbol | nil | 箭头 / 符号字体,如 ["Symbola"] |
:gui-font-emoji | nil | 彩色 emoji 字体,如 ["Noto Color Emoji"] |
3.6 搜索与进程输出
| 选项 | 默认 | 说明 |
|---|
:grep-program | nil | 项目 grep 用哪个程序("rg" / "grep")。nil = 装了 rg 用 rg,否则 grep |
:repos-scan | nil | magit-repos-view(C-x p G)扫描 git 仓库的根目录。nil = 当前项目根的上一级目录,再否则当前工作目录 |
:repl-buffer-maximum-size | 1000000 | REPL / 进程输出 buffer 最多留多少字符(照 comint-buffer-maximum-size),超了从开头截到行首;0 = 不限 |