Notepad++自动补全必须手动开启“启用每个输入的自动完成”和“函数参数提示”两项开关,否则所有补全功能均无效;.api文件需按位数放对路径、全小写命名;语言模式须正确设置(如CSS非CSS Embedded);插件冲突会导致菜单弹出但无法选择。

自动完成开关必须手动打开,否则所有补全都无效
Notepad++ 默认完全关闭自动补全,启用每个输入的自动完成 和 函数参数提示 这两个选项不勾选,就等于没配。很多人敲 std:: 没反应、输 docu 不出 document,第一反应是文件或插件问题,其实只是这两个开关还关着。
路径:设置 → 首选项 → 自动完成 → 勾选:
-
启用每个输入的自动完成(这是底层触发总开关) -
函数参数提示(影响括号内参数显示,CSS 属性值提示也依赖它) -
自动完成仅在输入字符后触发(不勾则必须按Ctrl+Space才弹出)
改完立刻生效,但已打开的文件可能需重新加载(Ctrl+O 再选一次),不用重启 Notepad++。
.api 文件必须放对路径且严格小写
C++ 补 printf()、JS 补 JSON.parse()、AHK 补 MsgBox,靠的是 .api 文件,不是语法高亮本身。放错位置、大小写错误、扩展名写成 .xml,都会导致补全列表为空。
关键规则:
- 64 位 Notepad++:放进
%PROGRAMFILES%\Notepad++\autoCompletion\ - 32 位 Notepad++:放进
%PROGRAMFILES(X86)%\Notepad++\autoCompletion\ - 文件名必须全小写,如
cpp.api、js.api、ahk.api,Cpp.API或cpp.xml都不识别 - 补全是前缀匹配:想看到
JSON.parse,得先输JSON.;只输parse不会出来
语言模式决定用哪套补全词典
补全不是全局生效的,它严格绑定当前文件的语言模式。状态栏显示 Normal text 或 HTML,哪怕文件是 style.css,CSS 属性也不会补全。
确认和修正方式:
- 看右下角状态栏:应明确显示
CSS、C++、JavaScript等,不是Normal text - 如果不是,点菜单栏语言 → 选对应项(注意:
CSS (Embedded)≠CSS,前者不加载 CSS 专属词典) -
.scss、.less等预处理器文件原生不支持属性补全,别白折腾.api文件
插件冲突比路径错误更难排查
补全菜单能弹出来,但按 Tab 或 Enter 没反应?大概率是插件劫持了快捷键。常见肇事者:QuickText、Python Script、NppExec,它们会拦截输入事件,让补全逻辑“卡住”。
快速验证方法:
- Win+R 输入:
"C:\Program Files\Notepad++\notepad++.exe" -noPlugin(路径按你实际安装位置调整) - 启动后打开同个文件测试补全是否恢复
- 若恢复正常,说明有插件干扰,逐个禁用插件定位
- 别把
.api文件扔进plugins\目录——它只认autoCompletion\子目录
补全失灵时,优先检查开关、语言模式、.api 路径这三项;插件冲突是最后才要怀疑的环节,但它一旦发生,现象最迷惑人——菜单有,就是按不动。

















