IntelliJ IDEA详细配置和使用（Java版）

ゝ一纸荒年。 2022-05-19 04:10 224阅读 0赞

写文章的目的是想把自己踩过的“坑”记录下来，如果与此同时能帮助到其他人我也很开心。

## 关闭Intellij IDEA自动更新 ##

在File->Settings->Appearance & Behavior->System Settings->Updates下取消Automatically check updates for勾选  
![关闭Intellij IDEA自动更新][Intellij IDEA]

## 隐藏.idea文件夹和.iml等文件 ##

IntelliJ IDEA项目会自动生成一个.idea文件夹和.iml文讲，看着实在是碍眼，所以对以上文件进行隐藏处理  
在File->Settings->Editor->File Types下的”Ignore files and folders”一栏添加 \*.idea;\*.iml;等配置如下图所示  
![隐藏.idea文件夹和.iml等文件][.idea_.iml]

## 代码编辑器主题风格 ##

编辑器风格修改个人并不推荐完全由自己来配置，因为网上提供了很多优秀的主题风格，我们可以导入自己喜欢的主题，然后在其基础上进行微调，推荐主题下载网站[http://www.riaway.com][http_www.riaway.com]，安装下载主题步骤:

1.从主菜单打开你的编辑器选择File->Import Setting.选择你下载的Jar文件;
    2.等待重启之后进行配置打开File->Settings->Editor->Colors and fonts 然后选择你安装的主题即可完成;

设置第一字体和第二字体，修改字体大小:  
自行去网上下载相应字体安装后重启Intellij IDEA，在主菜单下选择File->Settings->Editor->Colors & Fonts -> Font  
show only monospaced fonts表示筛选显示系统上的等宽字体，由于Windows系统上等宽字体并不多，勾选此选项出现的下拉字体可选择就很少，取消勾选之后，就可以显示系统上所有已安装的字体。我是按教程推荐配置，英文字体选择Monaco，此字体不支持中文，所以把这个设置为第一字体，第二字体使用Yahei Consolas Hybrid，该字体含有中文。字体大小我是修改为20，配置如下图所示:  
![代码编辑器主题风格][SouthEast]  
控制台输出字体和上述类似 此处不进行说明(控制台输出乱码即通过配置字体解决)

## 文件编码设置 ##

File->Settings->Editor->File Encodings

推荐设置

Global Encoding:UTF-8
    Projectt Encoding:UTF-8
    Default encoding for properties files:UTF-8
    勾选上Transparent native-to-ascii conversion

Transparent native-to-ascii conversion属性主要用于转换ascii，不然Properties文件的中文会被转码，IntelliJ IDEA除了支持对整个Project设置编码之外，还支持对目录、文件进行编码设置。如果你要对目录进行编码设置的话，可能会出现需要Convert编码的弹出操作选择，强烈建议在转换之前做好文件备份，不然可能出现转换过程变成乱码，无法还原。对单独文件的编码修改还可以点击右下角的编码设置区，如果代码内容中包含中文，则会弹出演示中的操作选择，Reload 表示使用新编码重新加载，新编码不会保存到文件中，重新打开此文件，旧编码是什么依旧还是什么，Convert 表示使用新编码进行转换，新编码会保存到文件中，重新打开此文件，新编码是什么则是什么。个人编码配置如下图所示：  
![文件编码设置][SouthEast 1]

## 类和方法注释模板 ##

1.修改类注释模板  
在File->Settings->Editor->File and Code Templates下分别修改Class，Interface，Enum等注释模板，Class模板部分修改如下，其余的举一反三进行修改。以下所示的$\{DESCRIPTION\}是自定义变量，会在创建类时请求输入

/**
      * Copyright (C), 2015-${YEAR}, XXX有限公司
      * FileName: ${NAME}
      * Author:   ${USER}
      * Date:     ${DATE} ${TIME}
      * Description: ${DESCRIPTION}
      * History:
      * <author>          <time>          <version>          <desc>
      * 作者姓名           修改时间           版本号              描述
      */
    #if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")
        package ${PACKAGE_NAME};
    #end
    
    /**
     * 〈一句话功能简述〉<br> 
     * 〈${DESCRIPTION}〉
     *
     * @author ${USER}
     * @create ${DATE}
     * @since 1.0.0
     */
    public class ${NAME} {
    
    }

类注释模板修改配置图  
![修改类注释模板][SouthEast 2]

类注释模板修改效果图  
![类注释模板修改效果图][SouthEast 3]

2.方法注释模板修改  
在File->Settings->Editor->Live Templates下添加自定义Template Group，并在自定义Template Group下添加自定义Template，具体配置如下图所示  
![方法注释模板修改][SouthEast 4]

详细配置参数

Template text内容如下:
    /**
     * 功能描述: <br>
     * 〈$END$〉
     *
     $param$
     * @return:$return$
     * @since: 1.0.0
     * @Author:$user$
     * @Date: $DATE$ $TIME$
     */
    
    Edit Template Variables请求参数部分内容如下:
    groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+='* @param ' + params[i] + ((i < params.size() - 1) ? '\\n ' : '')}; return result", methodParameters())

在完成如上配置后，只需在方法内执行/\*\*+Enter键即可生成注释，切记这里说的是方法内部，因为methodParameters()的作用域只在方法内部，这也是Intellij IDEA比较蛋疼的一点，博主在网上找了很久也没发现一个好的解决方案，网上也有人推荐使用JavaDOC插件生成注释,有兴趣的朋友也可以尝试一下

方法注释模板修改效果图  
![方法注释][SouthEast 5]

## 代码格式化 ##

代码格式化的快捷键为Ctrl+Alt+L，如果在类中执行代码格式化则会对代码进行排版，若焦点在类或者文件夹上，则会弹出格式化选项提示框，弹出框如下图所示:  
![代码格式化][SouthEast 6]

Include subdirectories:是否对子目录也进行格式化
    Optimize imports:优化导入的类和包
    Rearrange enries:对代码顺序进行调整(将Filed放在Method前边)
    
    Filters即配置过滤条件，表示对哪些文件进行格式化

## 自动导入所有包 ##

在Intellij IDEA一次只能导入单个包，没有像Eclipse快速导入包的快捷键Ctrl+Shift+O，但是Intellij IDEA下有个自动导入包的功能。在File->Settings->Editor->General->Auto Import下进行配置，具体配置如下如所示:  
![自动导入所有包][SouthEast 7]

Insert imports on paste:复制代码的时候，对于导入的包是否需要进行询问的一个选项。
        ASK(有需要导入的包名时会弹提示框，问你要不要导入)
        NONE(有需要导入的包名时不会弹提示框，也不会自动导入)
        ALL(有需要导入的包名时会自动导入，不会弹提示框)
    Show import popup:当输入的类的声明没被导入时，会弹出一个选择的对话框
    Optimize imports on fly:自动优化包导入，移除不需要的包
    Add unambiguous imports on the fly:这个就是自动导入功能了，当你输入类名后声明就被自动导入了
    Exclude from Import and Completion:这个其实就是你自定义import,可以不用关注，一般来说你是用不上的

## Maven配置 ##

在File->Settings->Build,Execution,Deployment->Build Tools->Maven下对Maven进行配置，个人配置如下图所示  
![Maven配置][Maven]

user settings file:指定Maven的settings.xml位置
    local repository: 指定Maven的本地仓库位置，是读取settings.xml自动配置的
    maven home directory:指定本地Maven的安装目录所在，因为我已经配置了MAVEN_HOME系统参数，所以直接这样配置IntelliJ IDEA 是可以找到的，但是假如你没有配置的话，这里可以选择你的Maven安装目录

![Maven配置][Maven 1]

VM options for importer:可以设置导入的VM参数，一般这个都不需要主动改，除非项目真的导入太慢了我们再增大此参数
    Import Maven projects automatically:表示IntelliJ IDEA会实时监控项目的pom.xml文件进行项目变动设置，建议进行勾选
    Sources和Documentation:表示在Maven导入依赖包的时候是否自动下载源码和文档，默认是没有勾选的也不建议勾选，原因是这样可以加快项目从外网导入依赖包的速度，如果我们需要源码和文档的时候我们到时候再针对某个依赖包进行联网下载即可，IntelliJ IDEA 支持直接从公网下载源码和文档的

## Maven聚合工程搭建 ##

1.创建父工程(不需要使用模板)  
![创建父工程][SouthEast 8]  
![创建父工程][SouthEast 9]  
![创建父工程][SouthEast 10]  
创建完父工程后删除父工程的src目录，该目录在聚合项目中无用

2.添加非web子模块  
![添加非web模块][web]  
![添加非web模块][web 1]  
![添加非web模块][web 2]

3.添加web子模块(使用maven web项目模板)  
![添加web模块][web 3]  
![添加web模块][web 4]  
![添加web模块][web 5]  
![添加web模块][web 6]

4.创建完查看工程目录结构如下  
![工程目录结构][SouthEast 11]

5.打开pom.xml文件 观察pom.xml文件的变化  
![Maven聚合工程pom.xml文件][Maven_pom.xml]

## 生成serialVersionUID ##

默认情况下Intellij IDEA关闭了继承了Java.io.Serializable的类生成serialVersionUID的警告，如果需要提示生成serialVersionUID，那么需要做以下设置:在File->Settings->Editor->Inspections下勾选中Java->Serialization issues->Serializable class without ‘serialVersionUID’，将光标放到类名上按Atl＋Enter键就会提示生成serialVersionUID了  
![生成serialVersionUID][serialVersionUID]

## 代码提示忽略大小写 ##

在File->Settings->Editor->General->Code Completion下设置Case sensitive completion为none  
![代码提示忽略大小写][SouthEast 12]

## IDEA脱离版本控制 ##

现在版本控制都有对应的优秀免费的开源客户端，而且稳定性更好。更多时候我们希望IDEA只是作为开发工具使用，而不参与版本控制，在File->Settings->Version Control下设置VCS为none即可脱离IDEA版本控制，配置如下

![IDEA脱离版本控制][IDEA]

### 可以安装一些插件： ###

**翻译插件 TranslationPlugin,支持支持中英互译、单词朗读,详细安装文档请参考:[TranslationPlugin介绍与安装手册][TranslationPlugin]**

### **热部署插件JRebel** ###

**JRebel热部署插件安装和使用请参考:[JRebel热部署插件安装和使用][JRebel]**

### **Maven Helper** ###

**Maven 辅助插件 用于查找Maven依赖冲突非常好用的一款插件 安装步骤请参考:[Maven Helper安装使用][Maven Helper]**

### **Properties to YAML Converter** ###

**在开发SpringBoot项目时，会需要把Properties的配置格式改为 YAML格式，Properties to YAML Converter提供了很好的支持**

### **阿里巴巴代码规范插件p3c-pmd** ###

**详细安装和使用请参考:[阿里巴巴代码规范插件p3c-pmd][p3c-pmd]**

[Intellij IDEA]: /images/20220519/707615aeaaff47b2b808c94b113456e4.png
[.idea_.iml]: /images/20220519/d2a6a81b7fb54718a5973fbecd1cb5b8.png
[http_www.riaway.com]: http://www.riaway.com
[SouthEast]: /images/20220519/8cf5cda678164619a625b02aa20d6771.png
[SouthEast 1]: /images/20220519/08d1ed5f8a8b4952915e5811a5383c34.png
[SouthEast 2]: /images/20220519/0d3a107f74df4ad0b662b741e1add150.png
[SouthEast 3]: /images/20220519/3a7a34d115694f2aba8cbd4db30d3c1e.png
[SouthEast 4]: /images/20220519/98d94a622c674efb90d80cdef399f1b5.png
[SouthEast 5]: /images/20220519/18c8a835a7ce439691108810fbee062d.png
[SouthEast 6]: /images/20220519/b8d67beb57e8468dbbe947b7c0c93c1a.png
[SouthEast 7]: /images/20220519/ec960f6cacac47439e3699cfb1477943.png
[Maven]: /images/20220519/f24fc483268e44bb93fc99ad33fb3209.png
[Maven 1]: /images/20220519/8cc6003e18064ec9b7ac3038bccd9136.png
[SouthEast 8]: /images/20220519/d381df2cbe204ffe97b31f30a320e6d8.png
[SouthEast 9]: /images/20220519/8dc0b6c52613470ba261aa8194d88871.png
[SouthEast 10]: /images/20220519/c27a737805364f1d8c91fe39ec0d4e7a.png
[web]: /images/20220519/0ac45e6d59db4507a4e3dd62c27cde97.png
[web 1]: /images/20220519/1343ae6e6dc84198849e184343fae949.png
[web 2]: /images/20220519/c224efaa71cc42a4acb6ee13e2338ef8.png
[web 3]: /images/20220519/2369f865464f4c8c8bbe01fba41f7936.png
[web 4]: /images/20220519/ec28f42a029b46e8b066bddfaa183adc.png
[web 5]: /images/20220519/c202c60395bd4e8193ca7b23d283642b.png
[web 6]: /images/20220519/a14b3bca9dc64e33b7de1c684977e303.png
[SouthEast 11]: /images/20220519/aa8f9feea44c4a63a0d8c57adde3b5ea.png
[Maven_pom.xml]: /images/20220519/e1b400924ea44a209e20910e4b9a17b3.png
[serialVersionUID]: /images/20220519/66a980107a9d4054a9d57a124a56635a.png
[SouthEast 12]: /images/20220519/4caa115ba0f54b0a8d8acd24d726778e.png
[IDEA]: /images/20220519/adedbc86814249d9b7ed1178f934cc7d.png
[TranslationPlugin]: https://github.com/YiiGuxing/TranslationPlugin
[JRebel]: https://youmeek.gitbooks.io/intellij-idea-tutorial/content/jrebel-setup.html
[Maven Helper]: https://my.oschina.net/u/136229/blog/678918
[p3c-pmd]: http://mp.weixin.qq.com/s/lBDe60LFpdXoi2xbA-L2Qg