navicat 17 sql自动补全不显示的主因是三个编辑器开关未同时启用、元数据未加载或光标位置无效；必须开启“使用自动完成代码”“显示关键字”“显示对象名”，并在合法语法位置（如from后、表名后加点）触发，且确保缓存已刷新。

navicat 17 的 sql 自动补全不显示，绝大多数情况不是功能坏了，而是三个开关没同时打开、元数据没加载、或光标停在了无效位置。

必须同时启用的三个编辑器开关

只勾选“启用自动完成代码”远远不够。Navicat 17 的补全是分层控制的，缺一不可：

• 使用自动完成代码（总开关，位于工具→选项→编辑器）
• 显示关键字（控制 SELECT、WHERE、JOIN 等语法词提示）
• 显示对象名（控制表名、字段名、视图名等数据库对象提示）

注意：部分汉化版把“自动完成”译作“自动补全”，搜索时请逐字核对；macOS 版路径为 Preferences → Editor，标签名可能是 Code Completion。

补全只在合法语法位置触发

按 Ctrl + Space 没反应，大概率不是快捷键失效，而是光标不在补全识别范围内：

navicatmysql

Navicat For MySQL

下载

• 在 FROM 后空格处输入，如 SELECT * FROM （光标紧贴空格后）
• 在已解析的表名或别名后加点号，如 users. 或 o.（o 必须已被识别为有效别名）
• 在内置函数名后加左括号，如 COALESCE(（仅限 Navicat 内置支持的函数）
• 写在注释里、字符串中（如 'SELECT *'）、或断连状态下的窗口中，补全完全不启动

元数据缓存未加载或损坏

Navicat 不实时查 information_schema，所有补全都依赖本地缓存。常见失效场景：

• 刚新建连接，首次使用前必须右键数据库节点（不是“表”文件夹）→ 刷新，等状态栏显示 Refreshing objects… 完成
• 新建了表或字段但补全不出现 → 右键该表 → Quick View，或执行一次 DESCRIBE table_name
• MySQL 连接若服务端启用了 lower_case_table_names=1，而客户端缓存仍按大小写敏感索引，需退出 Navicat 后手动删除 ~/Library/Application Support/PremiumSoft CyberTech/Navicat CC/Navicat Premium/ 下对应连接的缓存子目录
• PostgreSQL 用户需确认连接属性高级页中勾选了 Enable auto completion，且 search_path 匹配实际 schema

容易被忽略的兼容性与冲突点

这些细节常让补全“开了却像没开”：

• Ctrl + Space 在 Windows 上极易被中文输入法劫持；建议改用 Ctrl + Enter（Windows）或 Cmd + Enter（macOS）替代
• 国产系统（麒麟/UOS）下若用 Wayland 会话，补全菜单可能错位或无法交互，应切换至 X11 会话再启动 Navicat
• 延迟设为 0 会失效，推荐保持 300～500 毫秒
• v15.x 及更早版本不支持 JOIN 后多表字段提示、CTE 别名补全；v16.1+ 才真正重构补全逻辑

补全不弹出时，先看光标在哪、再看三个开关是否全开、最后检查缓存是否刷新——这三个动作覆盖了 95% 的真实问题。其他配置项（比如“仅在输入点后触发”）影响的是体验顺滑度，而非是否显示。