IntelliJ IDEA 2023.3 配置完全指南：从 JDK、Maven 到 Tomcat 的环境搭建

每次重装电脑或者换新机器，我都要把 IntelliJ IDEA 2023.3 的配置流程从头到尾走一遍：下载安装、配置 JDK、搞定 Maven、关联 Tomcat、装中文语言包、调字体和编码。看起来每一步网上都有教程，可真到自己动手，卡壳的地方一个都不会少，尤其是 2023.3 换了新界面之后，很多老教程里的菜单位置都对不上了。这篇文章干脆把我最近一次完整配置的过程整理成一份可以直接照着操作的详细步骤，尽量把每个入口、每个参数、每个容易踩的坑都写到位。无论你是刚接触 IntelliJ IDEA 的新手，还是重装系统后想快速恢复环境的老手，都可以直接拿这篇文章来参考，照着走一遍基本半小时内能把环境跑起来。

需要先说明一点：本文不涉及任何授权破解或者非官方激活手段。社区版本身免费，旗舰版有 30 天试用期，正常去官网下载安装包就够用了。下面进入正题。

1. 版本选型与安装选项：装错版本后面全白搭

1.1 社区版和旗舰版的区别，先搞清楚再下载

我见过太多人在第一步就栽了跟头：高高兴兴装了个 Community Edition（社区版），然后跟着网上的教程找Application Servers、找Java Enterprise项目模板、找 Spring 支持，结果翻遍设置界面都找不到。这不是你操作有问题，而是社区版从功能层面就把这一块砍掉了。

如果你只是学 Java 基础、做算法题、写点控制台程序，社区版完全够用。但只要你打算做 Web 项目，或者要跟着教程配置 Tomcat，我建议直接用旗舰版。先下个 30 天试用跑通整个流程，等确定适合自己了再考虑授权问题。这一步选错，后面所有配置步骤都会对不上号，浪费的时间远不止省下的那点安装功夫。

1.2 官网下载与安装选项细节

下载一定要去 JetBrains 官网，直接搜索“IntelliJ IDEA download”就能找到官方下载页。第三方下载站里的安装包很多是旧版本改过的，或者捆绑了推广软件，为了省这几分钟去冒这个险完全不值得。

安装过程中有几个选项值得说一下。安装路径我习惯放在非系统盘，比如D:\Program Files\JetBrains\IntelliJ IDEA 2023.3，这样以后重装系统不至于连 IDE 里的自定义配置一起丢掉。具体勾选建议参考这个列表：

• Create Desktop Shortcut：建议勾选 64-bit launcher，桌面快捷方式后面天天用。
• Update PATH variable：建议勾选，这样命令行里可以直接敲idea打开工程。
• Update context menu：可选，右键文件夹直接打开项目，用着挺顺手。
• Create Associations：把.java、.kt等文件关联给 IDEA，默认勾选即可。

第一次启动时，IDEA 会问你是导入配置还是跳过。如果是全新安装就直接选Do not import settings；如果你之前导出过配置，选Import Settings from选择压缩包即可。接下来会让你选主题，Light 或者 Dark 都行，后期在设置里可以随时切换。

2. 再理清 JDK 配置：全局入口和项目入口不是一回事

2.1 为什么 IDEA 里有两个配置 JDK 的地方

很多初学者最大的困惑就在这：为什么Project Structure里有个 SDK，Settings里也有个 SDK，它们到底什么关系？

简单说，IDEA 的 JDK 配置分两个层级：

• 全局配置：管的是你以后新建的所有项目默认用哪个 JDK。
• 项目配置：只管当前打开的这个项目用哪个 JDK。

在 2023.3 里，全局入口在Settings > New Projects Setup > Structure，项目入口在File > Project Structure。很多人只改了其中一个，结果新建项目时发现默认还是老的 JDK，其实就是改了当前项目，没改全局。反过来也一样，只改了新项目默认值，当前项目编译报错说 JDK 不对。这两个入口一定要都理解，配置的时候才不会两头空。

2.2 JDK 全局配置具体步骤

接着上一步说，全局配置路径是：File > Settings（快捷键Ctrl+Alt+S），然后在搜索框里输入SDK，或者依次展开New Projects Setup > Structure。右侧面板里找到Project SDK，如果下拉框里没有你要的 JDK，点旁边的Add JDK，在弹出的文件选择框里定位到你本机 JDK 的安装目录。

这里有个细节：JDK 安装目录要选到包含bin文件夹的那一层。比如你装在D:\Java\jdk-17，那就选这个目录，不要选到D:\Java\jdk-17\bin，选错的话 IDEA 会提示“不是有效的 JDK 目录”。我早期就犯过这个错，直接在文件选择器里点进 bin，结果系统说找不到。

配完全局，再看当前项目：File > Project Structure（快捷键Ctrl+Shift+Alt+S），左侧选Project，右侧SDK选择同一个 JDK。然后左侧切到Modules，确认每个模块的Module SDK也指向正确的 JDK。这里特别容易出现“Project 已经换成 JDK 17，Module 里还是 JDK 8”的情况，编译报错时第一反应应该是来检查这里。

2.3 JDK 版本怎么选才不纠结

2023.3 这个版本对 JDK 的支持范围很广，从 8 到 21 都能用。但具体用哪个版本，取决于你的项目需求：

我的建议是：电脑上可以同时装 JDK 8 和 JDK 17，IDEA 里配好两个 JDK 后，每个项目单独指定，互不干扰。新手不需要纠结“最新就是最好”，实际开发里很多公司还在用 JDK 8，关键是会配、会切换。

3. Maven 本地化：仓库路径和镜像源一次改对

3.1 为什么不用 IDEA 自带 Maven

2023.3 内置了 Maven，开箱即用，但实际开发时我强烈建议自己装一份单独的 Maven。原因有两个：

第一，内置 Maven 的默认本地仓库在 C 盘用户目录下，时间一长.m2文件夹会变得非常大，动辄几个 GB，塞在系统盘很容易让 C 盘空间告急。

第二，默认下载依赖走的是 Maven 中央仓库，在国内网络环境下经常“卡死”，一个依赖下到一半就超时。而自己装的 Maven 可以通过修改settings.xml配置阿里云镜像，把依赖下载速度提升一个量级。

自己安装 Maven 很简单：去 Maven 官网下载apache-maven-3.9.x-bin.zip，解压到比如D:\Maven\apache-maven-3.9.6，然后配置环境变量MAVEN_HOME指向这个目录，在Path里加上%MAVEN_HOME%\bin。装完在命令行执行mvn -v，能输出版本号就说明成功了。

3.2 settings.xml 中关键参数配置

Maven 安装完成后，进入conf目录，找到settings.xml文件，推荐配置如下：

<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd"> <!-- 本地仓库路径，建议放到非系统盘 --> <localRepository>D:/Maven/maven-repository</localRepository> <!-- 阿里云镜像，解决依赖下载慢的问题 --> <mirrors> <mirror> <id>aliyunmaven</id> <name>aliyun maven mirror</name> <url>https://maven.aliyun.com/repository/public</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors> </settings>

这里重点说两个参数：

• <localRepository>：本地仓库路径，指向一个你专门为 Maven 建的目录，比如D:\Maven\maven-repository。注意目录一开始可以是空的，Maven 第一次下载依赖时会自动创建。
• <mirror>：镜像配置。上面这段把中央仓库的请求都转发到阿里云镜像，实际体验下来，依赖下载速度能快好几倍。<mirrorOf>central</mirrorOf>表示只代理中央仓库，不影响其他仓库的请求。

3.3 在 IDEA 中关联 Maven 的完整操作

打开File > Settings（Ctrl+Alt+S），在搜索框输入Maven，进入Build, Execution, Deployment > Build Tools > Maven。这里有三个地方要改：

• Maven home path：选择你刚才安装 Maven 的目录，比如D:\Maven\apache-maven-3.9.6。如果你配置过环境变量，也可以直接选Bundled使用内置版本，但为了统一管理，我建议都改为自己装的。
• User settings file：勾选右侧Override，然后选择你改过的settings.xml路径。这一步很多人会漏掉，如果不点Override，IDEA 会继续使用默认的~/.m2/settings.xml，你改了 Maven 目录下的配置也不会生效。
• Local repository：勾选Override后，通常会直接读取settings.xml里的路径。如果没自动读取，就手动填成同样的本地仓库目录。

设置完成后再往下翻一点，把JDK for importer选成你本地的 JDK 版本，比如 17。这个选项控制 IDEA 导入 Maven 项目时用的 JDK，默认可能用内置的，版本不对会导致项目导入报错。

配置完成后，建议先在命令行执行mvn help:system，让 Maven 跑一次，确认本地仓库和镜像都生效。这条命令会下载一些基础插件，网络通不通、镜像配没配对，跑一次就有数了，不用等 IDEA 里建项目才发现问题。

4. Tomcat 关联与部署：从下载到跑通 Web 项目的完整链路

4.1 Tomcat 版本怎么挑

配置 Tomcat 前，先把下载这关把握好。Tomcat 主要用这几个版本：

我的建议是：学习阶段直接选 Tomcat 9.0，网上大部分教程和示例代码都是基于这个版本。Tomcat 10 之后的命名空间变化比较大，用老代码会遇到很多包名报错，新手容易被劝退。

下载时选zip压缩包（Windows 对应64-bit Windows zip），不要选Windows Service Installer那个 exe 安装版。zip 版解压后改一个文件夹名，比如D:\Tomcat\apache-tomcat-9.0.85，然后把解压目录里的bin\startup.bat先跑一次。浏览器访问http://localhost:8080，能看到 Apache Tomcat 默认页面，说明 Tomcat 本身没问题，再继续配置 IDEA。

4.2 在 IDEA 中添加应用服务器

打开File > Settings（Ctrl+Alt+S），搜索Application Servers，进入Build, Execution, Deployment > Application Servers。点击右上角的+号，下拉菜单里选择Tomcat Server。然后在Tomcat Home那一行选择你刚才解压的 Tomcat 目录，IDEA 会自动识别版本号并显示在下面，点击确认即可。

如果你到这一步找不到Application Servers这个入口，基本可以确定你装的是社区版。社区版不带应用服务器集成，解决方案只能是换旗舰版，或者先通过试用版把环境跑起来。

配置完成后，关闭设置。这时候再看工具栏上的运行配置区域，点Add Configuration，左侧列表里应该已经出现了Tomcat Server选项，展开后有Local和Remote两种，我们本地开发用Local。

4.3 新建 Web 项目并绑定 Tomcat 的完整流程

关联完 Tomcat 后，下一步创建一个 Web 项目来验证。

新建项目时（File > New > Project），在左侧选择Java Enterprise（旧版叫 Java Enterprise，2023.3 里就是这个名字），这里能看到 IDEA 对 Web 项目的一整套模板支持。右侧注意几个关键字段：

• SDK：选择你配置好的 JDK，比如 17。
• Build tool：选择 Maven。
• Application Server：下拉框里选刚才添加的 Tomcat，IDEA 会自动匹配版本。
• Configuration：勾选Web application。如果需要写接口，可以勾选REST service或Spring Web，但新手验证配置的话，一个 Web application 就够了。

点完成之后，IDEA 会生成一个标准的 Web 项目结构，里面有src/main/java、src/main/webapp、web/WEB-INF以及web.xml（如果选了生成 web.xml 的话）。

接着配置运行。点工具栏上的运行配置下拉框，选Edit Configurations，左上角+号，找到Tomcat Server > Local。配置界面里需要重点设置两个 Tab：

• ServerTab：Application server选择 Tomcat，Open browser可以勾选并填http://localhost:8080/项目名，On frame deactivation建议选Update classes and resources。这样一个页面切回 IDEA 时，改过的 JSP 或资源能自动热部署。
• DeploymentTab：点击+号，选Artifact，在弹出的列表里选项目名:war exploded，然后在Application context里填访问路径，比如/hello。

这里解释一下war和war exploded的区别。war是标准 Web 应用打包格式，部署时 Tomcat 需要整个解压；war exploded是展开的目录结构，IDEA 可以直接把目录映射给 Tomcat，改完代码页面刷新就生效。日常开发选exploded，只有正式发布时才打成war包。

配置完点击运行，Tomcat 会启动，浏览器自动打开http://localhost:8080/hello，看到一个 JSP 页面或者显示项目目录列表，说明从下载 Tomcat 到 IDEA 部署整条链路已经通了。

4.4 Tomcat 集成后最常见的三个报错

这一路配置下来，几个报错很典型，提前说一下省得大家来回查。

端口占用：启动报Port 8080 was already in use，说明有别的程序占了 8080。处理办法是去bin目录下执行netstat -ano | findstr 8080找到占用进程的PID，然后任务管理器结束该进程；或者直接在 IDEA 的 Tomcat 配置界面里换端口，HTTP port改成 8081 也行。

控制台中文乱码：Tomcat 日志里出现乱码，一般是编码不对。可以在 IDEA 的 Tomcat 运行配置里，VM options添加-Dfile.encoding=UTF-8，同时确认Settings > Editor > File Encodings三处都设成 UTF-8。还不行的话，改 Tomcat 的conf/logging.properties，把java.util.logging.ConsoleHandler.encoding改成UTF-8。

运行报 Error during artifact deployment：多数情况是 Artifact 配置有问题。先检查 Deployment 里是否加了war exploded，然后打开Build > Rebuild Project，再重新运行。如果还报错，把项目目录里的target和out文件夹删掉再重新构建一次，基本能解决。

5. 中文化、编码规范与界面调整：2023.3 的默认变化

5.1 官方中文语言包才是“中文版”的正解

严格来说，IntelliJ IDEA 官方安装包里并没有“简体中文版”这个选项，网上所谓的“中文版”其实是安装官方中文语言包。2023.3 中文化操作是这样的：

打开File > Settings > Plugins，切到Marketplace标签页，搜索框输入Chinese，找到Chinese (Simplified) Language Pack，这是 JetBrains 官方出的中文语言包，点Install安装，然后重启 IDEA。

重启之后，菜单栏、设置项、右键菜单都会变成中文。这套中文化是官方翻译，不像第三方汉化包那样夹杂广告或者改乱功能项，可以放心用。

中文化之后有一点容易迷惑：设置项的目录名和网上很多旧教程对不上了。比如Settings > Build, Execution, Deployment会显示成“构建、执行、部署”，但搜索框功能不受影响，直接用Ctrl+Alt+S打开设置，在搜索框输入英文关键词也能找到对应页面，不必担心看不懂。

5.2 新版 UI、字体与显示优化

2023.3 是 JetBrains 新 UI 全面铺开的一个版本，默认就是新版界面。如果你觉得新界面用不惯，可以切回旧版：打开设置，搜索New UI，取消勾选启用新 UI，重启后就是经典界面。我自己用下来，新 UI 的顶部工具栏更紧凑，暗色主题下的层次感也更好，2023.3 之后基本没有再切回去的想法。

字体的设置建议这样调：

• Settings > Editor > Font：编辑器字体选JetBrains Mono，字号 15 或 16，这个字体是 JetBrains 自家出的，等宽效果好，中文显示也清楚。
• Settings > Editor > Color Scheme > Color Scheme Font：如果你希望配色方案控制字体，就在这调整。勾选 “使用配色方案中的字体” 后，字体设置跟编辑区联动。
• 编辑区字体临时缩放：按住Ctrl键，然后滚动鼠标滚轮，可以临时放大缩小，这个功能在投屏演示时很实用。

另外还有一个舒适的设置：Settings > Editor > General > Code Folding，把方法体、import 块的折叠默认关掉，避免打开文件时看到一堆收起来的代码，影响读代码的连贯性。

5.3 Color Scheme 里找不到 JSP 配色的排查方法

很多人升级到 2023.3 后，在Settings > Editor > Color Scheme里翻了个遍，发现根本没有 JSP 的配色选项，然后怀疑是不是自己没装插件。这个问题我在自己机器上也遇到过，给你一个排查思路。

首先确定你用的是旗舰版。社区版不识别 JSP 文件，自然没有 JSP 配色。确认版本没问题后，去看项目里的 JSP 文件图标：如果 JSP 文件图标显示成了纯文本图标，说明 IDEA 没把它当成 JSP 来对待。

解决办法是去Settings > Editor > File Types，在左侧文件类型列表里找到Java Server Pages（有的版本显示为JSP），确保右侧注册的文件扩展名列表里有*.jsp。如果*.jsp出现在Text类型里，把它从Text的注册表里删掉，再手动添加到Java Server Pages类型的列表里。完成这步之后，JSP 文件就会被识别，Color Scheme里也会出现对应的配色设置项。

这套原理其实适用于 IDEA 里所有“文件类型识别错乱”的问题：字体颜色设置的前提是文件类型被 IDE 正确识别。先解决识别，再谈颜色。

6. 插件市场、AI 助手与配置迁移的常见坑

6.1 插件市场加载慢或装不上插件怎么办

插件装不上是个高频问题，特别是新装完 IDE，打开Plugins市场看到一直转圈，或者搜索不出结果。常见原因和处理办法大致是：

先在Settings > Appearance & Behavior > System Settings > HTTP Proxy里检查网络代理设置，如果公司内网有代理，需要填对代理地址和端口，IDEA 访问插件市场才会正常。

如果网络确实受限，连通不了 JetBrains 官方插件仓库，最稳妥的方式是手动下载离线安装包。去 JetBrains 插件商店页面找到你想要的插件，按照 IDEA 版本选择对应构建版本下载zip包。然后在Settings > Plugins页面点右上角的齿轮图标，选Install Plugin from Disk，选中下载好的 zip，安装后重启即可。

我不太建议去非官方网站下载所谓的“加速插件包”或者“破解插件的整合包”，一来来源不明，二来很容易夹带私货。业界有过不少插件投毒事件，轻则项目文件被改，重则账号信息被窃取，这个风险真的不值得冒。

6.2 在 IDEA 里接入 AI 工具的真实思路

最近经常看到有人问“IntelliJ IDEA 里能不能接入 Kimi”“2023.3 怎么用 AI 插件”。这里面有个基础认知需要先建立：绝大多数 AI 编程插件的本质，是一个可以填写 API Key 和模型地址的客户端。所以你只要搞清楚目标 AI 服务是否提供 API，以及它是否兼容 OpenAI 接口协议，就能在通用的 AI 插件里把它配置进去。

国内直接用起来比较省事的方案，是装通义灵码（Tongyi Lingma）或者CodeGeeX，这两者在插件市场直接搜索就能找到，注册账号后登录即可，不需要自己配 API 地址，对新手最友好。

如果公司内部已经有统一的模型服务，或者你确实想接某个指定模型，思路是这样的：先装一个支持 OpenAI 兼容接口的客户端插件，比如Continue，在它的配置里填上模型的Base URL和API Key，再把模型名切换成目标模型的标识。不同模型的请求格式会有细微差别，但只要服务商提供了 OpenAI 兼容接口，基本改改 URL 就能跑通。涉及 API Key，注意别把它提交到 Git 仓库里，GitHub 的代码扫描对这类密钥抓得很严，泄露了轻则扣费，重则账号被封。

6.3 配置导出与换机恢复，一次配好长期不折腾

配置一遍环境不容易，所以换电脑之前，我强烈建议把 IDEA 配置做一次备份。

备份方式有两种。第一种是 JetBrains 账号同步：Settings > Manage IDE Settings > Settings Sync，登录 JetBrains Account 后开启同步，插件、设置项、快捷键、配色方案都会同步到云端。换新机器时同一账号登录，IDEA 会自动拉取配置。但国内网络访问 JetBrains 服务偶尔不稳定，同步失败是常事。

第二种更可控：Settings > Manage IDE Settings > Export Settings，把配置导出成一个 zip。里面包含你的主题、代码风格、插件列表、运行配置模板。新机器上Import Settings选中 zip，几步就恢复完成。

我的习惯是两种都做：云端同步开着，本地每季度手动导出一份 zip 存到网盘。这样不管在哪台机器上，打开 IDEA 都是自己熟悉的布局和快捷键，恢复环境也就十分钟的事。

最后再分享一个我自己的配置习惯：拿到新电脑，我会先把 Maven 仓库固定到一个独立目录，比如D:\Maven\maven-repository，JDK 全部装在D:\Java下面，Tomcat 都放D:\Tomcat。目录统一的好处是以后备份、换机、排查路径问题时特别快，不用逐个位置去找。环境配置这件事，一次折腾到位，后面就能长期省心。希望这份基于 2023.3 的详细配置流程能帮你少走点弯路。