IDEA设置优化及常见问题解决方案

引言：IDEA是一款代码开发利器，舒服的设置、正确的编码姿势能让敲代码更加健步如飞、如履平地、事半功倍！该文档也包含了部分问题解决方案，欢迎阅读！
说明：IDEA版本2021.2.1，不同版本的IDEA，设置的名称可能不太一样，但大差不差

写在前面

IDEA设置，是分空间的，有单个项目，也有全局设置，单个项目只对当前项目生效，全局会对新建的项目生效（某些设置只会单个项目生效，如maven这种，建议全局设置所有设置）

• 单个项目的话直接点击File -> Settings...
• 全局的话，已经打开项目的点击File -> Close Project，将所有项目关闭，会跳转到下面这样一个窗口（没有打开任何项目的也是这个页面）
  
  然后点击Customize -> All settings...

1. 插件

好的插件能让你写代码事半功倍

1. Translation
   翻译功能，翻译快捷键Ctrl+Shift+Y
   该插件目前由于谷歌翻译接口访问不通，导致不太好用了，但是可以自己配置翻译接口，自己可以注册一个百度翻译接口，应该是有免费的请求次数

2. lombok
   实体类增强插件，通过注释就可以给实体类创建常用方法
   目前IDEA默认应该是安装了的

3. CodeGlance
   代码缩略图展示
   版本2、3、Pro都差不多，自己用的Pro

4. MybatisX
   可以生成代码，可以从Mapper类中快速找到xml中对应的方法

5. Rainbow Brackets
   可以给不同层级的括号添加颜色，避免混乱

6. Easy Code
   代码生成插件、可以生成Controller、Service、Entity、Mapper等，兼容MybatisPlus，也可以去前缀，类注释作者名称、sql-java类型匹配、模板等可以自己在File -> Settings... -> Other Settings -> Easy Code中配置

2. 修改字体（YaHei Consolas Hybrid）

我最常用的就是consolas字体了，但是我还感觉其中的默认宋体很难看，所以使用了微软雅黑版的consolas字体

Settings -> Editor -> Font，Font选择：YaHei Consolas Hybrid
字体资源下载：https://pan.baidu.com/s/1YATb_ObjCuARE1VUvjNqhg
提取码：fnee

3. 快捷键

1. Redo

   之前习惯了Ctrl+Y来撤销代码修改，Settings -> Keymap -> Main Menu -> Edit -> Redo：右键Add Keyboard Shortcut

2. Basic

   这是代码联想提示功能，之前习惯了Alt+/，Settings -> Keymap -> Main Menu -> Code -> Code Completion -> Basic：右键Add Keyboard Shortcut

注：修改的快捷键可能有冲突，IDEA会弹窗提示，直接Remove就可以

4. 修改maven

找到Settings -> Build,Execution,Deployment -> Build Tools -> Maven（其实直接搜索maven能更快找到）

• Maven home directory：D:\apache-maven-3.6.3-bin（maven路径）
• User settings file：D:\apache-maven-3.6.3-bin\conf\settings.xml（maven配置文件）
• Local repository：D:\maven_repository（maven本地库）

5. 修改字符编码Encoding

• Settings -> Editor -> File Encodings（yml中添加中文注释后启动报错问题解决）
  • Global Encoding：UTF-8
  • Project Encoding：UTF-8
  • Default encoding for properties files：UTF-8
• Help -> Edit Custom VM Options...，添加-Dfile.encoding=UTF-8（IDEA中tomcat的log中文乱码解决）

6. 修改JDK

• File -> Project Structure -> Platform Settgings -> SDKs，点击加号，找到自己的jdk文件夹进行添加（添加jdk）
• File -> Other Settings -> Structure for New Projects... -> Project Settings -> Project，修改Project SDK为自己的jdk（修改默认jdk）

7. 自动导入包

Settings -> Editor -> General -> Auto Import，勾选Add unambiguous imports on the fly和Optimize imports on the fly (for current project)

• 勾选标注第1个选项，IDEA 自动帮我们导入需要用到的包。但是对于那些同名的包，还是需要手动 Alt + Enter 进行导入的
• 勾选标注第2个选项，IDEA自动帮我们优化导入的包，比如自动去掉一些没有用到的包

如果想限制包的合并，打开Settings -> Editor -> Code Style -> Java，将Class count to use import with ‘*’ 和 Names count to use static import with ‘*’ 的值设置的都大一些，比如都设置为99

8. 去除mapper中色块

Settings -> Editor -> Inspection找到SQL下的No data sources configured和SQL dialect detection取消勾选

Settings -> Editor -> Scheme color -> General找到Code下的Injected language fragment选中，右侧设置取消勾选Background

9. 方法之间添加间隔线

Settings -> Editor -> General -> Appearance勾选Show method separators

10. 自定义mapper模板

Settings -> Editor -> File and Code Templates点击加号，Name填写mapper，Extension填写xml，文件内容如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="">
	
</mapper>

11. 自定义方法注释

Settings -> Editor -> Live Templates，点击加号添加组Template Group，我这命名为myDefine，再点击加号Live Template添加模板

Abbreviation自定义的关键词，我这里填写#，description是对该模板的说明，我填写“自定义方法注释”，然后Template text中添加如下内容

**
 * @description
 * @author 作者
 * @date $date$ $time$
 **/

点击Edit variables设置参数

点击OK，Expand with选中Enter

最下面有一个No applicable contexts的提示，点击Define，选择Java，点击OK就可以了

使用方法：在方法之前输入/#回车就能够自动添加自定义的注释了

12. 自定义类注释

Settings -> Editor -> File and Code Templates，在Class、Interface和Enum类名上添加如下内容

/**
 * @author 作者
 * @since ${DATE} ${TIME}
 **/

这样，新建java类时就自动添加类注释了

13. mapper中sql标签中报错：<statement> or DELIMITER expected, got ‘approve_id’

如下图，删除掉Local name中的sql|就可以了

14. 解决SpringBoot热启动失败

• File -> Settings... -> Build,Exception,Deployment -> Compiler，勾选Buil project automatically
• Alt+Ctrl+Shift+A+/，选择Registry，勾选compiler.automake.allow.when.app.running

15. yml中中文注释后启动报错

先将带有注释的代码去掉，然后修改如下配置，再将代码添加回去即可解决

16. unable to resolve column …

这个报错很烦人，直接使得mapper中一大片红色，网上很多解决办法都是配置数据源（几乎一模一样，不，简直就是那一个人写的），但是我就是不想配置（倔强），下面是我的解决方案（取消勾选Unresolved reference）

17. 添加背景图

File -> Settings... -> Appearance & Behavior -> Appearance，有一个按钮：Background Image…，点击后会出现下面的界面

• Image，图片地址，点击后面的...可以选择图片
• Opacity，透明度
• This project only，如字面意思，是否仅当前项目生效
• 后面的几个框
  • 前面的两个，第一个是水平翻转，第二个是垂直翻转
  • 大的第一个，保持图片原大小显示
  • 大的第二个，填充整个编辑器
  • 大的第三个，重复显示（图片大小小于编辑器大小时才能看出来）
  • 最后一个是对齐方式，如图九宫格，图片居上，下，左，右，中，上左，上右，下左，下右
• 最下面是预览效果，一个是打开文件带有代码的预览图，一个是没有打开任何文件的预览图