navicat不支持直接配置“公用代码片段库路径”或“远程url”，因代码段同步完全依赖on-prem server的拖拽/粘贴注册机制；本地snippets目录不参与同步，强行修改会导致启动异常。
navicat 本身不提供独立的“公用代码片段库”配置入口，所谓“团队公用”完全依赖 navicat on-prem server 的对象共享机制实现——不是靠本地配置，而是靠拖拽或粘贴动作触发同步。
为什么不能直接配置“公用库路径”或“远程 Snippet URL”
Navicat 的 代码段 功能设计上是本地 + 云端双态：内置代码段只读、用户代码段默认存于本地配置目录（如 Windows 下为 %AppData%\PremierSoft\Navicat Premium\Snippets），但该目录**不参与任何自动同步**。强行修改或替换此目录内容会导致 Navicat 启动异常，且不会推送到 On-Prem Server。
真正能被团队共用的，只有明确“注册到 On-Prem Server 项目中”的那些 代码段。它们的存储位置、权限、生命周期均由服务器管理，客户端只是视图代理。
如何让一个代码段真正变成团队公用
必须完成以下任一操作，否则它永远只存在于你本机：
- 在查询编辑器中创建好新
代码段后，**不点“保存”到本地库，而是直接拖拽到导航窗格里的 On-Prem Server → 对应项目 → 查询 → 代码段**（注意：必须拖到“项目下的代码段”，不是 Server 根节点） - 若已保存为本地代码段，需先在
代码段窗格中右键该条目 → “复制”，再在导航窗格中展开目标 On-Prem Server 项目 → 右键“代码段”节点 → “粘贴” - 新建代码段时，在“新建片段”对话框里勾选
保存到项目（Navicat 17.1+ 版本可见该复选框），并从下拉菜单选择目标 On-Prem Server 项目
完成上述任一动作后，该 代码段 即刻出现在所有已加入该项目成员的 Navicat 导航窗格中，且实时响应编辑变更——无需手动刷新、无需重新登录。
常见同步失败现象和排查点
你以为共享了，但队友看不到？大概率卡在这几个环节：
- 拖拽目标错误：拖到了 On-Prem Server 根节点下的“代码段”，而不是“某项目 → 代码段”。前者是全局模板区（仅管理员可见），后者才是成员协作区
- 项目权限不足：你在 On-Prem Server 中只是“成员”角色，但目标项目未给你
编辑代码段权限（需项目所有者在“项目设置 → 角色权限”中勾选） - Navicat 版本不一致：低于 17.0 的客户端无法识别 On-Prem Server 推送的
代码段元数据，会静默忽略；建议统一使用 17.2 或更高版本 - 网络策略拦截：On-Prem Server 默认走 WebSocket 长连接同步，若企业防火墙封锁了
wss://或非标准端口（如 8080/8443），会导致代码段列表空白或显示“加载中…”
本地代码段 vs 团队代码段的本质区别
二者在 UI 上看起来一样，但底层行为完全不同：
- 本地
代码段：存储在客户端磁盘，修改后仅自己可见；导出为.snippet文件可手动分发，但无版本、无冲突解决、无审计日志 - 团队
代码段：实际存储在 On-Prem Server 数据库中，每次编辑都会生成一条活动日志（含操作人、时间、diff 内容），且支持按标签/数据库类型筛选——这个筛选逻辑是服务端执行的，不是客户端过滤 - 性能影响：团队代码段首次加载略慢（需拉取元数据），但后续 TAB 补全响应速度与本地无异；大量未使用的团队代码段不会拖慢启动，因为 Navicat 是按需加载
最易被忽略的一点：团队代码段的占位符（如 ${table}）在不同成员机器上输入时，TAB 键跳转顺序是严格一致的，但光标初始位置可能因客户端字体渲染差异发生偏移——这不是 bug，是跨平台文本测量的固有特性，建议统一使用等宽字体（如 Consolas）避免混淆。
