navicat 本身不提供开箱即用的团队级公共代码片段库，但可通过 navicat on-prem server 实现跨成员、跨连接、实时同步的共享；本地 .xml 导入导出仅为静态快照，存在重复跳过、无版本审计、硬编码失效、无权限控制等缺陷。
Navicat 本身不提供开箱即用的「团队级公共代码片段库」，但通过 Navicat On-Prem Server 可以实现真正的跨成员、跨连接、实时同步的共享。本地单机模式下的片段（.xml 导入导出）只是临时搬运，不是协作方案。
为什么直接导出 .xml 文件不能算“公共库”
导出的 .xml 文件只是静态快照，存在几个硬伤：
- 导入时缩写重复会静默跳过，没人知道是否覆盖成功
- 修改后需重新导出 → 通知所有人 → 手动导入，无版本、无审计、无冲突提示
- 片段里若写死
users表名或'active'值，换项目就失效；而$1占位符又依赖使用者知道要填什么 - 无法限制只读权限——任何人导入后都能删改，没有“只读共享片段”概念
用 Navicat On-Prem Server 搭建真正可用的公共片段库
这是目前唯一支持权限控制、实时同步、集中管理的路径。2024 年起所有 Navicat Premium 17+ 版本默认支持，无需额外插件：
- 管理员在
Navicat On-Prem Server后台创建一个专用项目（如shared-sql-snippets） - 登录该服务器的任意成员，在自己本地 Navicat 的 SQL 编辑器中新建片段 → 保存时选择目标为该服务器项目，而非本地连接
- 保存后，所有拥有该项目「查看」或「编辑」权限的成员，打开任意数据库连接的 SQL 编辑器，都能在代码片段窗格里看到它（带云图标标识）
- 右键片段可查看「作者」「最后修改时间」，活动日志里能追溯谁改了哪一行
团队使用时必须统一的几件事
否则共享片段会变成新坑源：
- 缩写必须全局唯一且语义明确：
selu（select user）可以，q1不行；避免和内置sel/ins冲突 - 所有硬编码值一律替换为占位符：
WHERE status = '$1' AND created_at > '$2';$0，并在片段「备注」里写清$1 = 'active'|'inactive' - 禁止在内容中使用双引号包裹字符串——Navicat 对
"json"解析不稳定，统一用单引号 + 连续两个单引号转义：'{"name": ''John''}' - 新建片段时「标签」选统一分类（如
common/pg-only），方便后期按数据库类型筛选
真正的难点不在搭建，而在约定：片段不是扔进服务器就完事，它得像 API 文档一样有输入说明、适用场景和兼容性标注。没人维护的共享库，三个月后就会退化成废弃文件夹。
