3. 核心选项

核心默认值在 coxn.editor/default-options。全部用 (set-option! 键 值) 设置。

3.1 编辑与缩进

选项默认说明
:tab-width8Tab 字符的显示宽度(照 Emacs)。EditorConfig 的 tab_width / file-local 可按 buffer 覆盖
:indent-offset4每级缩进的空格数。语言主模式可自带默认(Clojure / Lisp 系是 2);EditorConfig / file-local 可按 buffer 覆盖
:fill-column70M-q(fill-paragraph)与 auto-fill 的行宽(Emacs 默认 70)
:electric-pairfalse自动补全括号 / 引号(M-x electric-pair-mode 开关;Emacs 默认关)
:show-parentrue高亮匹配的括号(show-paren-mode,Emacs 28 起默认开)
:line-move-visualtrueC-n / C-p 按屏幕行走(长行折行时逐屏幕行;Emacs 默认)
:scroll-margin0预留(Emacs scroll-margin 的对应项;当前版本尚未消费)

3.2 界面与显示

选项默认说明
:display-line-numbersfalse行号。M-x display-line-numbers-mode(当前 buffer)/ global-display-line-numbers-mode(全局)
:mousetrue终端鼠标(xterm-mouse-mode)。开着时 Shift+拖动仍是终端自己的选择;M-x xterm-mouse-mode 开关
:extended-keystruekitty 键盘协议 / modifyOtherKeys:让终端送得出 C-; C-? C-S-a 等组合键
:which-key-delay-ms500按下前缀键后多久弹出 which-key 提示
:tab-bar-modefalse顶部标签栏(M-x tab-bar-mode 开关)
:minibuffer-display:bottomminibuffer(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-scale1.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-autotrue打字停下自动弹补全(corfu 手感)。M-m t a 开关
:completion-auto-delay-ms150停下多久后自动弹
:completion-auto-prefix2符号至少打够几个字符才自动弹(. -> :: 这类触发字符不受此限)
:completion-sync-wait-ms300补全请求发出后先同步等这么久:来源都回来了就当场出结果,否则转异步浮框(不超过 :lsp-timeout-ms)

3.4 文件、自动保存与持久化

选项默认说明
:auto-reverttruebuffer 没改过、文件在外面被改了 ⇒ 自动重读
:auto-savetrue自动把改过的 buffer 存一份副本(不碰原文件)
:auto-save-interval300每多少次按键触发一次自动保存
:auto-save-timeout-ms30000空闲多少毫秒触发一次自动保存
:auto-save-dir<cache>/auto-save自动保存目录;文件名照 Emacs 编码(/#路径编码#)
:make-backup-filestrue每次会话第一次存盘前,把原文件复制一份备份
:backup-dir<cache>/backup备份目录(文件名 路径编码~)
:save-placetrue记住每个文件的 point / 窗口位置,重开恢复(文件改动后靠上下文找回)
:save-place-file<config>/save-place.ednsave-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-fontnil主字体,如 ["JetBrains Mono" "Fira Code"]
:gui-font-sizenil(= 14)字号,单位 sp(桌面端 ≈ px;照 Emacs :size),如 14
:gui-font-cjknil全角 / 汉字字体,如 ["Noto Sans Mono CJK SC"]
:gui-font-symbolnil箭头 / 符号字体,如 ["Symbola"]
:gui-font-emojinil彩色 emoji 字体,如 ["Noto Color Emoji"]

3.6 搜索与进程输出

选项默认说明
:grep-programnil项目 grep 用哪个程序("rg" / "grep")。nil = 装了 rg 用 rg,否则 grep
:repos-scannilmagit-repos-view(C-x p G)扫描 git 仓库的根目录。nil = 当前项目根的上一级目录,再否则当前工作目录
:repl-buffer-maximum-size1000000REPL / 进程输出 buffer 最多留多少字符(照 comint-buffer-maximum-size),超了从开头截到行首;0 = 不限

原始 Markdown:coxn 使用手册(Markdown) · 安装包:coxn 产品页