最直接的判断方式是输入sublime.log_input(True)观察控制台输出:无输出说明按键被系统或输入法拦截,有输出则表明按键已进入Sublime,需进一步排查绑定覆盖或IME配置问题。

控制台输入 sublime.log_input(True) 看按键是否被捕获
这是最直接的判断方式:如果中文输入法根本没把按键传进 Sublime,后续所有插件配置都白搭。按 Ctrl+` 打开控制台,输入 sublime.log_input(True) 回车,再随便打几个中文拼音(比如 “ni hao”),观察控制台是否有类似 key evt: shift+n、key evt: shift+i 这样的输出。
如果没有输出,说明系统或输入法在拦截——搜狗/QQ 拼音默认用 Ctrl+Alt+M 切输入法,它会吃掉组合键;微软拼音也可能在“高级设置”里启用了快捷键冲突项。此时要先切到美式键盘或禁用输入法快捷键,再试。
候选框是否随光标实时移动,而非固定在左上角或副屏
插件生效的核心表现不是“能打字”,而是“候选框坐标准确”。打开一个新文件,用方向键或鼠标反复切换光标位置(行首、行中、空行、缩进深处),同时保持输入状态(比如一直输拼音不点空格)。观察候选框:
- 若它始终紧贴光标下方(哪怕光标在行尾、折叠代码块里、高 DPI 缩放 150% 下),说明
enable_ime+hardware_acceleration: "none"+ 魔改版IMESupport全部到位 - 若候选框跳到左上角、卡在屏幕边缘、或随鼠标移动但不同步光标,大概率是
hardware_acceleration没关,或你装的是 Package Control 里那个原版IMESupport(它不支持 ST4 高分屏) - 若只在某些字体(如 Courier New)下错位,而换成
Microsoft YaHei或Consolas就正常,说明是字体度量值导致垂直偏移,不是插件问题
检查控制台有没有 IMESupport 加载报错
重启 Sublime 后,立刻按 Ctrl+` 看控制台顶部几行。魔改版 IMESupport 启动时会打印类似 IMESupport: loaded, DPI-aware mode enabled 的日志。如果看到 ImportError: No module named 'xxx' 或 AttributeError: 'NoneType' object has no attribute 'get',常见原因有:
-
IMESupport文件夹名写成了IMESupport-master(必须去掉-master) - 插件目录放错了位置:必须是
Packages/IMESupport/ime_support.py,不能嵌套在子文件夹里 - 之前装过旧版,残留了
IMESupport.sublime-settings或缓存文件,建议手动删掉整个IMESupport文件夹再重装
输入法状态栏是否显示“中文”且可正常选词
有些用户误以为“能打英文=插件生效”,其实关键在输入法上下文是否被正确识别。在 Sublime 里输入拼音后,注意看 Windows 任务栏右下角输入法状态栏:
- 若显示“中”字图标,按空格/回车能出候选词,说明 IME 上下文建立成功
- 若一直显示“英”字,或按
Shift切中文后立刻变回英文,说明enable_ime没启用,或者 Sublime 版本低于4126(ST4 早期 build 不支持该选项) - 若状态栏正常但候选框不出现,优先检查 GPU 渲染和 DPI 设置,这两项比插件本身更容易漏配
hardware_acceleration 和“替代高 DPI 缩放行为”必须同时生效,缺一不可。

















