补全弹窗被遮挡是因CodeMirror默认z-index偏低与phpMyAdmin高z-index容器冲突，需在custom.css中设.CodeMirror-hints{z-index:9999!important}；同时修复overflow/transform截断问题，并确保库表加载、关闭自动刷新、避免中文输入法下触发补全。
补全弹窗被顶部导航栏或左侧菜单盖住
codemirror 补全弹窗的 z-index 默认值偏低，而 phpmyadmin 5.x 的 .navbar 和 #serverlinks 容器层级过高，导致弹窗被压在下面。这不是浏览器兼容问题，是 css 层级冲突。
实操建议：
- 确认已启用补全：
$cfg['SQLQuery']['EditInline'] = true;和$cfg['SQLQuery']['CodeMirrorEnable'] = true;都必须设为true，否则根本不会渲染弹窗 DOM - 在
custom.css中强制提升弹窗层级（注意：必须加!important）：.CodeMirror-hints { z-index: 9999 !important; } - 避免同时设置
.navbar或#serverlinks的z-index值——它们本身没设z-index，靠文档流顺序堆叠；强行加反而可能破坏折叠逻辑
补全弹窗出现在屏幕外或位置偏移
CodeMirror 计算弹窗坐标依赖父容器尺寸和滚动偏移，而 phpMyAdmin 的 .sqlquery 区域常被包裹在多个 position: relative 的 div 中（如 .container、.tabpane），一旦某层未设 overflow: visible 或存在 transform，就会截断或错位弹窗。
实操建议：
- 用 DevTools 检查弹窗父级链路，找到第一个带
overflow: hidden或transform的祖先元素（常见于.tabpane或.container-fluid） - 在
custom.css中重置该容器：.tabpane, .container-fluid { overflow: visible !important; transform: none !important; } - 不要试图修改 CodeMirror 源码里的
position: absolute逻辑——它会随光标动态计算 top/left，硬改会导致在不同行触发时定位失准
输入时弹窗闪退或不出现
不是卡顿，而是 CodeMirror 插件在检测到焦点离开编辑区、或 DOM 被重绘时主动销毁弹窗。phpMyAdmin 5.2+ 在「SQL」页切换标签（如从「格式化」切回「SQL」）或点击左侧数据库列表时，会触发整个右侧面板重载，导致弹窗 DOM 被清空。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 确保补全上下文稳定：先点开目标库 → 展开要用的表（哪怕只点一次箭头），再切到 SQL 页；刚切库后立即输入，缓存未加载，弹窗会因无字段数据而快速消失
- 禁用自动刷新：右上角「启用自动刷新」开关必须关闭，否则每 30 秒轮询一次，强制重绘页面，弹窗无法维持
- 避免在子查询中间触发补全：比如写
SELECT * FROM (SELECT ... ) AS t WHERE t.，光标停在t.后，CodeMirror 不解析别名上下文，弹窗要么空白要么立刻关闭
中文输入法下弹窗位置错乱
CodeMirror 对 IME（输入法编辑器）的兼容性差，尤其在 Chrome 下，中文输入过程中光标位置反馈延迟，导致弹窗锚定到错误坐标。这不是 phpMyAdmin 独有，但它的容器嵌套加深了问题。
实操建议：
- 输入字段名时，先用英文键盘敲
t.，再切换中文输入法补全值——避免在补全弹窗展开状态下直接打中文 - 临时禁用 CodeMirror 的自动提示，在
config.inc.php中加：$cfg['SQLQuery']['AutoSave'] = false;
，减少编辑器内部状态干扰 - 如果频繁遇到，说明当前环境（浏览器 + phpMyAdmin 版本 + 中文字体渲染）组合不稳定，比修复弹窗更实际的做法是：复制字段名到本地编辑器补全，再粘贴回 phpMyAdmin
补全弹窗被遮挡看似是样式问题，实际是三层耦合的结果：CodeMirror 的定位逻辑、phpMyAdmin 的 DOM 嵌套结构、浏览器对 position: absolute 在复杂布局下的渲染偏差。修一层不如锁住上下文——先确保库/表已加载、自动刷新已关、输入法状态干净，再动 CSS。
