代码片段窗口需在SQL编辑器内用Ctrl+Shift+S（Win/Linux）或Cmd+Shift+S（macOS）打开；缩写须纯英文、无空格、不冲突内置名（如sel）；内容需纯文本格式，避免隐藏字符；导入时同名缩写会被静默跳过。
代码片段窗口打不开？先确认编辑器焦点和快捷键
按 Ctrl+Shift+S（Windows/Linux）或 Cmd+Shift+S（macOS）唤出代码片段侧边栏，但这个操作只在 SQL 编辑器内有效。如果光标停在连接列表、表结构页或结果面板，快捷键完全没反应。常见误操作是刚新建完查询就立刻按键，其实得先点一下编辑区空白处让输入焦点落进去——看到光标闪烁了再按。
片段窗格默认不自动展开，也不能靠鼠标点击菜单“工具→代码片段”打开（该路径实际调出的是旧版弹窗，功能受限）。必须用快捷键触发侧边栏，且首次使用后它会记住位置，下次自动停靠在右侧。
新建片段时缩写填错，等于白做
缩写（Abbreviation）是插入唯一入口，不是名称也不是描述。填 selu，之后在编辑器里输入 selu + Enter 就能插入；但若缩写含空格、中文或超过 4 字母（如 select_user），Navicat 直接忽略，不会报错也不会提示。
- 避开内置缩写：
sel、ins、upd、del是 Navicat 预留的，自定义别碰 - 命名要具体：用
sel_user_active比user_query更容易在搜索时定位 - 内容里别留首尾空行：多一个换行，插入后光标跳到下一行，常被误认为“没插上”
占位符 $1/$2 不跳转？检查片段内容格式
占位符生效前提是片段内容用纯文本写入，且未混入隐藏字符。从网页、Markdown 或微信复制 SQL 进来，极易带全角空格、零宽字符或混合换行符（\r\n 和 \n 并存），导致 $1 显示为普通文本，Tab 键无法聚焦。
正确做法：先把 SQL 粘贴进记事本（Windows）或 TextEdit（macOS 纯文本模式），删掉所有多余空行，用 Tab 控制缩进（别用空格堆），再复制进片段的「内容」框。例如：
SELECT * FROM users WHERE status = '$1' AND created_at > '$2';$0
其中 $0 表示最终光标位置，$1 和 $2 是可跳转填写的参数位。插入后按 Tab 可依次替换，但 Navicat 不校验值类型或是否为空——填错字符串没引号、数字漏了单引号，执行时直接报错。
片段导入后不显示？静默跳过重复缩写
每个 Navicat 连接（.ncx 文件）独立存储片段，跨连接复用必须导出/导入 XML。但导入时如果目标环境已有同名缩写（哪怕内容不同），Navicat 不提示、不覆盖、不报错，而是直接跳过该条目——你看着 XML 文件成功加载了，列表里却没新增。
协作或重装后恢复片段，务必提前清理旧缩写：
- 右键片段组 →「编辑」→ 手动删掉冲突项
- 或导出前，在源环境中把缩写批量改成带项目前缀，比如
proj_sel_user - 导入后立刻在搜索框输入缩写测试，别只看列表长度
真正卡点不在创建，而在维护：缩写是全局唯一 ID，不是标签，改一次就得同步所有环境，否则团队里有人用 selu，有人用 sel_user，模板就散了。
