拼写检查#
IntelliJ IDEA可帮助您确保所有源代码(包括文本字符串,注释,文字和提交消息)拼写正确。为此,IntelliJ IDEA提供专用的Typo 检查,默认情况下启用。
在文本字符串和注释中,插入符号中单词的拼写可以更改为正确的拼写。在启用重命名重构的上下文中 ,检查建议重命名符号的所有匹配项。
检查单词的拼写#
随着错字启用检查,IntelliJ IDEA的检测,并强调不包括在任何字典单词。您可以提供正确的拼写或按原样接受该单词。如果单词被接受,它将被添加到您选择的自定义词典中,并在将来被拼写检查器跳过。如果错字检查被禁用,所有的错别字被忽略。
纠正拼写错误的单词#
-
将插入符号放在Typo检查突出显示的单词上。
-
单击
或按Alt+Enter以显示可用的意图操作。
-
选择更改为意图操作,然后从建议列表中选择所需的拼写。
接受拼写错误的单词#
-
将插入符号放在Typo检查突出显示的单词上。
-
单击
或按Alt+Enter以显示可用的意图操作。
-
选择“ 保存到字典”操作以将该单词添加到用户的字典中,并在以后将其跳过。如果未选择默认字典,IntelliJ IDEA将允许您选择要将单词保存到的字典。
要删除刚添加的单词,请按Ctrl+Z。
配置字典使用#
根据捆绑的词典和用户定义的自定义词典检查拼写的正确性。由于拼写检查功能不允许您实际更改语言本身,因此添加自定义词典将允许您为IntelliJ IDEA带来几乎任何语言支持。
字典可以是以下任何一种:
-
内置的项目级和应用程序级词典,您可以通过手动将单词保存到它们来填充。
-
带有DIC扩展名的纯文本文件,包含用新行分隔的单词。
-
Hunspell词典包含两个通常共享相同名称的纯文本文件,例如 en_GB.dic和en_GB.aff。该DIC文件中包含的单词列表连同适用修改规则。在AFF文件列表的前缀和后缀由特定的变更规则监管。字典中的hunspell可以在网上轻易获得的,例如,在这里。
Hunspell支持由相应的Hunspell插件提供。该插件未与IntelliJ IDEA捆绑在一起,但可以从JetBrains插件存储库中安装, 如管理插件中所述。
选择要使用的词典#
-
在“ 设置/首选项” 对话框(Ctrl+Alt+S)中,选择“ 编辑器”下的 “ 拼写”。
-
在 打开的 拼写页面上,切换到词典选项卡。
在“ 自定义词典”区域中,配置要使用的自定义词典。
-
在“ Bundled Dictionaries”区域中,通过选中或清除它们旁边的复选框来配置要使用的捆绑字典。
填充内置词典#
您可以使用拼写检查期间应跳过的单词手动填充内置项目级和 应用程序级词典。
添加一个接受的单词#
-
在“ 设置/首选项” 对话框(Ctrl+Alt+S)中,选择“ 编辑器”下的 “ 拼写”。
-
在 打开的 拼写页面上,切换到“ 接受的单词”选项卡。
-
创建一个单词列表:
-
单击
以打开“ 添加新单词”对话框并在其中指定新条目。 不支持CamelCase或snake_case。如果您尝试添加一个已包含在其中一个拼写词典中的单词,IntelliJ IDEA将显示一条错误消息:单词<just typed word>已经在词典中。
-
要从列表中删除项目,请选择该项目并单击
。
-
配置拼写检查选项#
设置拼写检查默认值#
-
在“ 设置/首选项” 对话框(Ctrl+Alt+S)中,选择“ 编辑器”下的“ 拼写”。
-
在 打开的 拼写页面上,切换到词典选项卡。在“ 高级设置”区域中,选择是要将内置 项目级别 还是应用程序级别字典用作保存单词的单个字典。
如果未选择默认字典,IntelliJ IDEA将允许您选择保存单词的单词,以便在错误输入的单词上调用“ 更改为......意图”操作。
-
如有必要,使用旋转框限制拼写检查器建议的单词数。
配置错字检查#
-
在“ 设置/首选项” 对话框(Ctrl+Alt+S)中,选择“ 编辑器”下的“ 检查”。
-
在打开的“ 检查”页面上,展开“ 拼写”节点,然后在中央窗格中单击“ 拼写错误 ”。
-
在右侧窗格中,配置错误检查:
-
在“ 选项”区域中,通过选择或清除“ 处理代码”,“ 处理文字 ”和“ 处理注释”复选框,定义要检查的内容类型 。
-
在“ 严重性”区域中,选择检查严重性级别以及应用此级别的 范围。
-
TODO评论#
有时,您需要标记代码的一部分以供将来参考:优化和改进的领域,可能的更改,要讨论的问题等等。IntelliJ IDEA允许您添加特殊类型的注释,这些注释在编辑器中突出显示,编入索引并在TODO工具窗口中列出。这样您和您的队友就可以跟踪需要注意的问题。
默认情况下,有通过的IntelliJ IDEA认可的两种模式: TODO
和FIXME
两个大写和小写。这些模式可以在任何支持的文件类型的行和块注释内使用。您可以根据需要修改默认模式或添加自己的模式。
要创建多行TODO项,请缩进初始行后面的注释行。如果没有缩进,则将行视为常规注释行。要禁用多行TODO项目,请打开“ 设置/首选项”对话框(Ctrl+Alt+S),然后转到“ 编辑器”| TODO并清除以下行中的缩进文本作为同一TODO复选框的一部分。
要查看TODO项目,请打开TODO工具窗口: View | 工具窗口| TODO或Alt+6。
要跳转到源代码中的TODO注释,请单击TODO工具窗口中的相应TODO项。要禁用此行为,请右键单击TODO工具窗口标题栏,指向“ 查看选项”,然后清除“ 自动滚动到源”选项(在这种情况下,您需要双击TODO项目以跳转到相关注释)。
添加自定义模式并过滤TODO项目#
您可以添加自己的模式并过滤列表以仅显示与某些模式匹配的TODO项目。例如,您可以选择使用OPTIMIZE
模式在代码中标记可能的优化位置,并在TODO工具窗口中查看时忽略所有其他类型的TODO项:
-
在Settings / Preferences 对话框(Ctrl+Alt+S)中,选择Editor | TODO。
-
要为
OPTIMIZE
项添加模式,请单击TODO对话框的Patterns部分中的Add图标(),然后键入以下模式:
\boptimize\b.*
然后单击“ 确定”以保存新模式。
-
要使用新模式添加过滤器,请单击“ TODO”对话框的“ 过滤器”部分中的“ 添加”图标(
),指定新过滤器的名称(例如,),然后选择要包含在此过滤器中的新模式。
Optimization
然后单击“ 确定”以保存新过滤器。
-
单击“ 确定”以在“ TODO设置”对话框中应用更改。
-
要应用新过滤器,请在TODO工具窗口中,单击“ 过滤TODO项目”图标(
),然后选择“ 优化”过滤器。
语言注入#
语言注入允许您处理字符串文字内的代码片段以及类似XML的语言中的标签或属性。
如果在字符串文字,标记或属性中有一段正式语言(例如HTML,CSS,XML,RegExp等),则可以获得全面的语言帮助来编辑该片段。
在开始使用语言注入之前 ,请确保 已启用IntelliLang插件 。
暂时注入语言#
-
将光标放在要注入语言并按Alt+Enter (或使用意图操作图标
)的字符串文字,标记或属性中 。
-
选择“ 注入语言”或“引用”,然后选择要注入的语言。
在专用编辑器部分打开代码片段#
-
将插入符号放在注入的代码段中并按Alt+Enter (或使用意图操作图标
)。
-
选择编辑<语言ID>片段。
IntelliJ IDEA将打开一个专用的编辑器部分,用于使用注入的语言编辑代码。此编辑器提供完整的代码帮助,包括代码完成,检查,意图和代码样式操作。
使用语言注释评论#
-
在目标字符串文字前添加一个空行,然后键入以下注释:
-- language=<language_ID>
对于注释,请使用要注入的语言的语法。语言ID通常是直观的,例如SQL,RegExp,XML,HTML。
语言片段可以与作为包装器一起起作用的前缀和后缀组合,将片段转换为语法上完整的语言单元。编辑代码时,只能在片段编辑器中看到前缀和后缀。它们不会显示在主编辑器中。
前缀和后缀可以包含在注释注释中,如下所示:
// language=<language_ID> prefix=<prefix> suffix=<suffix>
使用@Language注释#
在某些语言中(例如,在Java,Groovy或Kotlin中),您还可以使用@Language("language_ID")
注释来注入语言。
-
在目标字符串文字之前的空白行上,键入
@Language("language_ID")
。 -
将光标放在注释上,按,然后Alt+Enter选择“ 添加'注释'到类路径。
IDE将提示您从Maven下载带有注释的库。
-
在搜索字段中,键入
org.jetbrains:annotations:16.0.2
是否使用JDK 1.8或更高版本。对于JDK 1.5,1.6或1.7,请键入
org.jetbrains:annotations-java5:16.0.2
。 -
单击确定。
-
按,Alt+Enter然后选择导入类。
配置注入规则#
您可以在编辑器上配置语言注入规则 IntelliJ IDEA设置的语言注入页面(Ctrl+Alt+S)。
所有预定义的注入规则都是为内置范围配置的。换句话说,它们是全局的(因此可用于所有IntelliJ IDEA项目)。可以为IDE或仅为一个项目配置自定义规则。要更改自定义进样的范围,请使用 图标。
要配置自定义注入规则,请单击 以添加新规则,或复制预定义规则并更改其设置。
示例:在Java中注入SQL #
您可以配置设置,以便每次使用某种方法时,IDE将注入所选语言,例如SQL。
-
在设置/首选项对话框(Ctrl+Alt+S)中,转到 编辑器| 语言注射。
-
单击
并选择 Java参数。
-
从ID列表中,选择SQL。
-
在“ 类方法”字段中,输入要获取SQL参数的方法。您可以手动键入方法,也可以
在“ 选择类”对话框中单击并选择方法。
如果该方法采用多个参数,它们将显示在对话框中。选择要使用的那些。
-
应用更改并关闭对话框。
取消注射#
-
将光标放在代码片段上,然后按Alt+Enter (或使用意图操作图标
)。
-
选择取消注入语言/参考。
要取消语言注入,您还可以删除注入注释或注释。