Notepad++中文网下载 - Notepad++官网

Notepad++中文网下载 - Notepad++官网

什么是notepad自动补全?

Notepad++ 在输入初始子字符串(或前缀)后会自动补全各种文本,这样可以省去打长词的麻烦(也可能避免打错字)。例如,如果你用 JavaScript 编写代码并输入 syn,Notepad++可以作为提示显示同步 (JavaScript 关键词)。你通过输入完成键(见下文“ 自动完成 ”)接受建议,单词会在缓冲区内完成,就像你已经全部打出来一样。如果建议词不是你想要的,请继续输入。

如果候选词列表中有多个词与你输入的匹配,Notepad++ 会显示包含这些词的列表;列表中高亮的单词是完成键中将被选中的单词,但你可以使用 Down-arrow & & PageUp ,来在列表中移动;或者,输入 Esc 以驳回该列表。

Notepad++ 使用三组候选词来创建建议;这些称为“字”、“函数”和“系统路径”。

函数完备


“函数”预先定义并加载,连同对应文件计算机语言的词汇表。(词汇器定义语法着色;自动补全文件指定函数名称。)通常这些函数词包括语言关键词(技术上不是函数),如 C 语言中的 switch 及类似语言,或 Python 中的 lambda,以及一套标准库函数名称,如 C 语言中的 assert 或 fdopen

这些函数列表存储在自动补全定义文件中,每个文件根据其语言命名。(这些文件中的词语不一定包含词汇定义中列出的所有关键词。)这些文件可以指定哪些词是关键词,哪些是函数;函数支持额外的补全功能“参数提示”。本文件中的函数和关键词在整个文档中都被视为“函数补全”。

参数提示

自动补全定义文件可以指定关键词是否为函数。当输入函数名称并加上用于包裹函数参数的开头括号时,Notepad++ 会自动或手动显示提示(也称为“调用提示”):一个小巧的工具提示式框打开,内含函数描述的文本。虽然实际显示的文本由定义文件的作者决定,但通常至少会显示函数调用中每个参数的一个关键词。这可能帮你省去查找函数文档去记住这些参数的麻烦。

如果当前函数有多个提示定义,工具提示框中会出现上下箭头(▲ ▼)。你可以点击这些箭头,或者使用 Alt+UpArrow 快捷 Alt+DownArrow 键来循环查看参数提示。(这些快捷键未被显示在快捷键映射工具中,也未受其影响。键盘快捷键是 v8.4.5 新增的。)

如果在自动补全设置中选择了开括号选项,Notepad++ 会自动显示提示。用户也可以在菜单中选择“函数参数提示”,或者当插入号位于函数调用的开头和闭合括号之间时,通过按键(默认: Ctrl+Shift+Space )选择。同样,提示可以用 Esc 忽略。

单词补全

“单词”取自当前文件——文件中无处不在、注释和代码中。任何两个字符或以上的单词都会被添加到列表中。这包括数字,但带有小数点的数字被分为两个不同的“单词”。

路径完成

与功能和字补全不同,后者可以在按 1 次(或 X 次)键后自动触发,路径补全需要手动触发,通过快捷方式(默认: Ctrl+Alt+Space )或通过菜单命令“ 编辑 > 自动补全 > 路径补全 ”在输入驱动器后触发(例如“C:”)。如果插入点左侧的字符串不属于系统路径,路径列表就不会出现。

自动完成

完成列表可在输入时自动触发,进入设置 > 偏好设置 > 自动完成进行配置:自动完成功能由复选框控制开启。同时可以设置 “从第 X 个字符开始”,即输入前缀达到多长时显示补全列表(常用 2、3、4 位);还可以指定补全候选内容:仅单词、仅函数,或两者同时启用。
自动补全开启后,输入达到最小长度的前缀时,会弹出列表显示所有匹配的可选内容。若无匹配项则不显示。列表可能只有一项,也可能包含多项需要上下选择,你可以用方向键或鼠标浏览,按补全键或双击某项即可直接填入完整内容;按 Esc 键可关闭补全弹窗,不选择任何内容。
如果不做选择继续输入,不匹配的项会从列表中移除,直到输入内容无任何匹配时列表完全消失。若按 Esc 关闭后继续输入,且内容仍匹配词条,补全列表会再次出现。

补全键

v8.2 及更早版本中,Tab 和 Enter 默认为补全键,不可配置。
v8.2.1 到 v8.3 默认仅 Tab 为补全键,可在偏好设置中选择启用 Tab、Enter 或两者。
v8.3.1 及更新版本默认同时启用两个补全键,同样支持在设置中自定义。
升级不会覆盖已保存在 config.xml 中的配置,只有全新安装或配置文件缺失、重建时,才会使用上述默认设置。

手动补全

关闭自动补全后,仍可手动触发补全,并可限定只补全函数或只补全单词。默认快捷键为:Ctrl+Space(补全函数)、Ctrl+Enter(补全单词),也可在编辑菜单中找到对应功能。
使用快捷键或菜单命令会立即尝试补全:若只有一项匹配则直接填入,不显示列表;多项匹配时则弹出选择列表。
注意:手动函数补全目前会列出词库中所有函数,即使与当前前缀不匹配,若无任何函数匹配前缀则不显示列表。手动单词补全只显示匹配项,若仅有一项则直接补全而不弹出列表。

自动插入

许多符号习惯成对出现,编辑器可在输入左半部分时自动补全右半部分。
设置 > 偏好设置 > 自动完成里的 “自动插入” 选项中,可以选择自动匹配五种预设符号:圆括号、方括号、大括号、双引号、单引号。除此之外,还可以自定义三对字符,例如输入 Unicode 左引号时自动补全右引号,每个框仅允许填写单个字符。
输入左符号时,右符号会自动插入,光标置于两者之间。为避免误触发,自动插入仅在满足以下条件时生效:
  • 光标位于空的圆括号、方括号或大括号之间

  • 光标前后均为空白字符(空格、制表符、行首或行尾)

  • 光标前为空白,后为右括号、右方括号或右大括号

不满足以上条件则不会自动插入。
此外,自动插入支持 HTML 和 XML 标签自动闭合。启用后,输入开始标签会自动补全结束标签,光标置于中间,即使标签带有属性也可正常匹配。若开始标签以 / 结尾,则不会补全闭合标签。

显示补全列表

手动补全时,列表只显示对应类别内容:要么只有单词,要么只有函数。自动补全触发时,会同时显示匹配的单词和函数。
补全列表会用图标区分内容:自动补全配置文件中标记为函数的条目显示 “fx” 图标;普通关键字显示立方体图标;从当前文档提取的单词无图标。

自动补全设置

主要自动补全配置在设置 > 偏好设置 > 自动完成
手动补全的快捷键可在设置 > 快捷键映射器的 “主菜单” 选项卡中,按 “编辑” 分类查找,也可直接筛选 “补全” 快速定位。

创建自动补全定义文件

Notepad++ 使用 XML 文件配置各语言的函数与参数自动补全,补全文件放在安装目录下的 autoCompletion 子文件夹中。
补全文件语法简单,但必须保证格式正确、排序规范。语法错误会导致 XML 加载失败,该类型文件无法使用自动补全。
自动补全 XML 文件必须使用 UTF-8 无 BOM 编码。
关键词排序不当会导致补全功能异常,部分词条无法正常触发。
可识别的关键词基本字符为大小写字母、数字和下划线。标点符号可用于简单补全,但如果需要参数提示功能,关键词名称中不能使用标点。
对于普通关键字,使用自闭合的 <KeyWord> 标签,仅包含 name 属性。
如需让关键字显示函数提示,需添加 func="yes" 属性,此时 <KeyWord> 为非自闭合标签,内部包含重载与参数定义。
每个函数重载对应一个 <Overload> 节点,一个函数至少需要一个重载才能显示提示。retVal 属性为必填项,用于声明返回值类型;descr 为可选属性,用于填写函数说明,可使用换行符分隔内容。每个参数使用 <Param> 标签表示,name 属性必填,用于填写参数类型或名称。
<AutoComplete> 标签可添加 language 属性,仅用于标识,程序本身不会使用该值。

自动补全文件格式

自动补全文件存放在安装目录的 autoCompletion 文件夹中,不支持放在用户配置目录。文件为可选,需要为哪种语言启用补全就创建对应文件,用户自定义语言同样支持,文件命名格式为 <语言名称>.xml
为默认的普通文本语言添加自定义补全,可创建 normal.xml
文件根节点为 <NotepadPlus>,内部包含一个 <AutoComplete> 节点,其下为自闭合的 <Environment> 标签,可用属性如下:
  • ignoreCase:是否忽略大小写,区分大小写填 no,默认 yes

  • startFunc:参数列表起始字符,默认为 (

  • stopFunc:参数列表结束字符,默认为 )

  • paramSeparator:参数分隔符,默认为 ,

  • terminal:函数原型结束符,支持 C 风格独立声明时默认为 ;,不支持则留空或使用非法字符

  • additionalWordChar:额外允许的单词字符,顺序不限,不可使用空格

所有属性均可省略,<Environment> 标签本身也可省略,但不推荐这样做。
后续为一系列 <KeyWord> 标签,必须按名称升序排序。排序规则由 ignoreCase 决定:忽略大小写则按大写字母排序,区分大小写则按字符字节值排序。
函数类型关键字需设置 func="yes",内部包含至少一个 <Overload>,每个重载可带返回值、说明和多个 <Param> 参数。所有文本内容受内部缓冲区限制,总长度不可超出限制。

名称与特殊字符

为保证参数提示和函数补全正常工作,关键字建议只使用大小写字母、数字和下划线。仅做名称补全时可使用空格或自定义分隔符,但这类字符会导致参数提示无法显示。ASCII 以外的特殊字符不支持函数补全与参数提示。
在返回值、说明或参数中使用特殊字符,需使用十六进制 XML 实体,格式为 &#xhhhh;,十进制实体格式不支持。

排序

<KeyWord> 必须严格按名称升序排列,否则可能导致补全失效且无提示。
区分大小写排序可使用编辑菜单中的行操作 > 字典序升序排序
不区分大小写排序需手动将小写视为大写处理,下划线应排在所有字母之后,内置排序功能不适用此场景。

验证自动补全文件

开发自动补全文件时,如需验证 XML 语法正确性,可查阅官方社区中关于配置文件 XML 验证的相关说明。


«    2026年4月    »
12345
6789101112
13141516171819
20212223242526
27282930
搜索
控制面板
您好,欢迎到访网站!
  查看权限
网站分类

Powered By Z-BlogPHP 1.7.5

Copyright Your WebSite.Some Rights Reserved.