EverEdit 4.3 函数提示设置指南

EverEdit 4.3 函数提示设置指南

一 功能说明与适用范围

• EverEdit 的“函数提示”主要依赖三类机制协同工作：
  1. 语法着色文件（.mac）中定义语言的关键字/内置函数清单；
  2. 代码片段（.snippet）提供函数骨架与参数占位；
  3. 自动完成在输入时弹出候选，支持按Enter/Tab采纳，列表前缀标识来源（如：@ 代码片段、- 上下文、* 语法关键字）。在 4.3 版本中，函数参数提示通常通过上述组合实现（而非内置 LSP 的参数悬浮窗）。

二 快速启用自动完成

• 开启功能：依次点击 文档 -> 自动完成，确保启用。
• 触发方式：在代码里输入函数名或触发词时会出现补全列表，按 Enter 采纳第一项，或用方向键选择；若列表同时包含函数和代码片段，优先选择带 @ 的片段以获得参数模板。
• 提升命中率：确保当前文档被正确识别为对应语言的语法模式（见下节）。

三 让函数名出现在提示列表

• 核心做法是为所用语言编写或完善 .mac 语法着色文件，在文件中声明该语言的关键字/内置函数（以及注释、字符串、折叠等规则）。这样自动完成会把函数名作为“语法关键字”来源参与提示。
• 放置路径：将语法文件保存到 EverEdit 安装目录的 syntax 文件夹（例如：syntax\yourlang.mac）。
• 关联文件类型：在 工具 -> 设置 -> 语法着色 中为你的语言添加扩展名（如：.js、.py），必要时编辑语法文件以完善关键字清单。完成后，函数名将出现在自动完成的“* 语法关键字”列表中。

四 为函数添加参数模板与快速插入

• 使用代码片段为常用函数建立模板：
  1. 打开 查看 -> 停靠窗格 -> 代码片段，在面板中选择与当前文档类型匹配的语言；
  2. 右键 新建片段，填写触发词（如：for、if、你的Func），在编辑区写入模板（可用占位符/光标停留位）；
  3. 保存后，在编辑器中输入触发词即可弹出列表，双击或回车插入；插入后可用 Tab 在占位符间跳转。
• 绑定到语法：若新建分组未生效，需在 工具 -> 设置 -> 语法着色 -> 编辑 的语法文件（.mac）中添加该分组的绑定说明，使片段只在对应语言下出现。

五 常见问题与排查

• 输入函数名却没有提示：检查是否打开了 文档 -> 自动完成；确认文件类型与语法模式匹配（在 工具 -> 设置 -> 语法着色 中核对扩展名/语法）；必要时完善 .mac 中的关键字定义。
• 代码片段不弹出：在代码片段面板中确认选择了正确语言，并为分组添加语法绑定；确保触发词与当前输入匹配。
• 无参数提示：EverEdit 4.3 通常不在输入时自动展开函数签名，建议采用“代码片段模板 + Tab 跳转”的方式补齐参数；也可在模板中预留注释或示例参数以作提示。