Navicat代码片段无法跨平台迁移，需导出为UTF-8无BOM的XML文件再导入，并手动清理换行、空格、引号及占位符，避免缩写冲突与环境差异导致失效。
代码片段不随.ncx配置文件自动迁移
Navicat 的代码片段（Code Snippets）存储在连接配置文件 Connections.ncx 内部，但不是明文嵌入，而是以加密或结构化二进制方式绑定到特定平台和主版本。Windows 上保存的 Connections.ncx 直接复制到 Linux 系统后，即使 Navicat 版本号一致（如 v16.2），片段也大概率无法加载——Linux 版客户端会静默跳过解析失败的片段区块，导致窗口里空空如也。
必须导出为 XML 文件再导入
跨平台复用唯一可靠路径是绕过 .ncx，改用 Navicat 内置的标准化导出机制：
- 在 Windows 版 Navicat 中打开「工具 → 代码片段」，右键目标片段组 → 「导出代码片段」，生成一个
.xml文件（如my_snippets.xml） - 将该文件复制到 Linux 系统，确保编码为 UTF-8（无 BOM）；可用
file -i my_snippets.xml验证，若显示charset=iso-8859-1，用iconv -f iso-8859-1 -t utf-8 my_snippets.xml > fixed.xml转换 - 在 Linux 版 Navicat 中打开代码片段窗口，点击「导入代码片段」→ 选中该
.xml文件
注意：导入时若缩写（abbreviation）已存在，Navicat 不提示、不覆盖、不报错，直接忽略新条目。务必先删旧片段再导入。
导入后需手动检查占位符与换行
Windows 导出的 .xml 可能含 \r\n 换行及隐藏 Unicode 空格（如 U+00A0），导致 Linux 下插入后格式错乱或执行报错：
- 打开导入后的片段 → 「编辑」→ 全选内容 → 在纯文本编辑器（如
vim或 VS Code）中粘贴清理：删除所有空行、统一用 Tab 缩进、替换全角空格为 ASCII 空格 - 检查占位符是否仍为
$1、$0形式；若被转义成\$1或消失，需手动还原 - 涉及字符串值的字段（如
WHERE name = '$1'），确认单引号未被意外替换成中文引号「’」
缩写冲突与环境差异易被忽略
看似只是“复制粘贴”，但实际有三个隐性断点：
-
sel、ins、upd等内置缩写在各平台行为一致，但自定义缩写如sel-user在 Linux 下可能因键盘布局或输入法触发异常（比如输入sel-后 Tab 键未响应） - Windows 用户习惯用 Ctrl+Shift+T 呼出片段窗口，Linux 默认快捷键可能是 Ctrl+Shift+T 或 Ctrl+Alt+T，需进「工具 → 选项 → 快捷键」核对
- 片段中硬编码的数据库名、表名（如
SELECT * FROM orders）在 Linux 环境下若大小写敏感（MySQLlower_case_table_names=0），执行会直接报错Table 'orders' doesn't exist；建议改用SELECT * FROM $1占位
真正卡住人的往往不是导出动作本身，而是导入后第一次按 Tab 跳转时光标没出现在预期位置，或执行瞬间报出一个和 SQL 无关的语法错误——那八成是换行或引号惹的祸。
