企业官网建设流程全解析

简介：这份PDF资料聚焦IntelliJ IDEA中右键项目缺失Run运行选项这一高频配置故障，面向刚接触IDEA的Java初学者及需要排查环境问题的开发者。内容从Sources目录、SDK、Output目录到Java版本四个层面逐项拆解，并配有示例代码与对比截图，帮助读者定位src未标记为Sources、JDK未引入、输出路径缺失及源发行版无效等典型报错。资源包共1个PDF文件，约454KB，篇幅紧凑，适合作为随查随用的排错手册。目前已有32971人学习下载，说明该问题在开发实践中相当普遍。读者可据此掌握IDEA项目结构配置的完整思路，快速恢复运行与调试能力，减少因环境配置不当而浪费的时间。

1. 右键没有 Run，先别急着重装 IDEA

刚装完 IntelliJ IDEA，拉下来一个 jeecgboot 或者任意 Maven 工程，右键main方法，菜单里干干净净，没有 Run 那一项。第一反应往往是「是不是装了个假 IDEA」「是不是社区版阉割了」，甚至有人直接去搜 idea 破解版安装教程 2024 准备重装一遍。先打住，这几乎不是安装包的问题，而是工程配置没对齐。

IDEA 判断一个 Java 文件能不能跑，靠的不是文件后缀，而是三件事：这个目录有没有被标记成 Sources Root、模块有没有绑定 SDK、编译输出路径有没有指定。三者缺一个，右键菜单就不会给你 Run 的入口，因为 IDE 自己都不知道拿什么 JDK 去编译、编译产物往哪放。这篇就把这套配置从根上讲清楚，顺带把「无效的源发行版」这类连锁报错一起收拾掉。适合刚接触 IDEA 的 Java 新手，也适合换了机器、重装了 IDE 之后发现老项目跑不起来的老手。

2. 为什么右键没有 Run：IDEA 的模块模型拆解

2.1 Run 选项出现的三个前置条件

很多人以为 Run 是跟着文件走的，其实它是跟着「模块 + 源根 + SDK」这套组合走的。IDEA 的工程结构是 Project 套 Module，一个 Project 可以挂多个 Module，每个 Module 独立维护自己的源目录、依赖和输出路径。右键一个main方法时，IDEA 内部会做一次判定：这个文件所在的目录是不是被标记为 Sources Root？所在 Module 有没有关联有效的 SDK？有没有配置编译输出目录？三个条件全绿，Run 才会出现在右键菜单里。

新装的 IDEA 打开一个已有工程时，如果这个工程不是通过 IDEA 自己的向导创建的，而是从 Git 上 clone 下来、或者从别人那拷贝过来的，.idea目录里的模块配置很可能缺失或者不完整。这时候 IDEA 会退化成「纯文本编辑器」模式——能看代码，但不认识工程结构。表现就是：src 目录图标是普通文件夹，不是蓝色的源根；Java 文件里import java.util.List这种 JDK 自带的包都标红；右键自然也没有 Run。

这里有个反直觉的点：IDEA 社区版完全支持 Java 的 Run/Debug，不存在「社区版不能跑 Java」这回事。社区版缺的是 Spring、Java EE 那类企业级框架支持，跟能不能右键 Run 一个main方法毫无关系。所以别把锅甩给版本。

2.2 Sources Root 标记到底改了什么

把目录标记为 Sources Root，本质上是往模块配置里写了一条 source folder 记录。IDEA 靠这条记录知道：编译时要去这个目录下找.java文件，包名从这一层开始算。没标记的话，IDEA 不知道src/main/java是源码根，就会把com.xxx这样的包名当成普通目录名，编译入口自然找不到。

标记 Sources Root 有两种路径，效果一样：

• 右键目标目录 →Mark Directory as→Sources Root
• 打开Project Structure→Modules→Sources标签页 → 选中目录 → 点Sources按钮

第一种快，适合单个目录；第二种能看到整个模块的目录分类全貌，适合排查「到底哪个目录没标对」。jeecgboot 这类多模块工程，往往每个子模块都有自己的src/main/java，需要逐个确认。

2.3 SDK 与 Language Level 的绑定关系

SDK 是 IDEA 用来编译和运行的 JDK 本体，Language Level 是「按哪个 Java 版本的语法规则来解析代码」。两者是分开配置的，这也是「无效的源发行版: 12」这类报错的根源——SDK 装的是 JDK 8，但 Language Level 被设成了 12，编译器按 12 的规则去解析，本地又没有 12 的 JDK，直接报错。

一个模块的 SDK 配置在Project Structure→Modules→Dependencies里的Module SDK下拉框。这里如果显示<No SDK>，就是没绑。绑的时候选Project SDK表示跟随项目级设置，选具体某个 JDK 表示模块级覆盖。多模块工程里，如果某个子模块用了不同的 JDK 版本，就在这里单独指定。

Language Level 则在Project Structure→Project和Modules→Sources两处都有。Project 级是默认值，Module 级可以覆盖。常见做法是全部对齐到本地实际安装的 JDK 版本，比如本地是 JDK 8，那 Project、Module Sources、Module Dependencies、Java Compiler 四处都设成 8。

3. 四步配置实操：从 Sources 到 Java 版本

3.1 第一步：标记 Sources 目录

打开Project Structure（快捷键Ctrl+Alt+Shift+S，Mac 是Cmd+;），进Modules→Sources。左侧是模块树，选中目标模块，中间是目录树。找到src/main/java，选中，点上方Sources按钮，目录会变蓝。如果还有src/main/resources，选中点Resources，会变成资源根图标。

这一步做完，Java 文件里的 JDK 包引用报错通常会消失一部分。如果还报错，说明 SDK 没绑，继续下一步。

提示：如果Modules列表里压根没有你的模块，说明 IDEA 没把这个工程识别成 Maven/Gradle 工程。去右侧 Maven 面板点一下刷新，或者右键pom.xml→Add as Maven Project。

3.2 第二步：绑定模块 SDK

还在Modules里，切到Dependencies标签页。看Module SDK下拉框，如果是<No SDK>，点开选一个已配置的 JDK。如果下拉框里一个 JDK 都没有，点New...→JDK，指向本地 JDK 安装目录，比如C:\Program Files\Java\jdk1.8.0_xxx或/usr/lib/jvm/java-8-openjdk。

选好之后，下面的依赖列表里应该能看到 JDK 的条目。这一步做完，import java.util.*这类报错应该全消失。

3.3 第三步：指定编译输出路径

这一步对应那个经典报错：

Cannot start compilation: the output path is not specified for module "design-patterns". Specify the output path in the Project Structure dialog.

意思是模块没有编译输出目录，IDEA 编译完的.class文件没地方放。解决位置在Project Structure→Project→Project compiler output，填一个目录，比如工程根下的out或者target。填完之后，每个模块默认会继承这个路径，在Modules→Paths里能看到Compiler output已经自动填好。

如果某个模块想单独指定输出路径，就在Modules→Paths里勾Use module compile output path，分别填Output path和Test output path。一般项目用项目级统一输出就够了，不用逐个改。

3.4 第四步：四处 Java 版本对齐

这是最容易漏的一步，也是「无效的源发行版」反复出现的根源。总共有四个地方要设成同一个版本，以本地 JDK 8 为例：

Java Compiler 那一项，如果工程里有多个模块，Target bytecode version是一张表，每个模块一行，逐行确认。Project 级的 Language level 是默认值，Module Sources 里如果显示Project default就跟随项目级，如果被单独改过就要手动对齐。

四处全部设成 8 之后，右键main方法，Run 选项应该就回来了。如果还没有，往下看避坑章节。

4. 避坑与排查：那些让人怀疑人生的报错

4.1 现象：Sources 标了，SDK 绑了，Run 还是不出现

原因：模块根本没被 IDEA 识别。常见于 clone 下来的工程.idea目录被.gitignore排除，IDEA 打开时只当普通文件夹处理。

解决：关掉工程，删掉工程根目录下的.idea文件夹（如果有），重新用Open打开工程根目录，IDEA 会重新扫描pom.xml或build.gradle并生成模块配置。Maven 工程打开后等右下角依赖下载完，再检查 Sources 和 SDK。

4.2 现象：报错Error:java: 无效的源发行版: 12

原因：Language Level 或 Java Compiler 的 target 被设成了 12，但本地只有 JDK 8。这个 12 往往是从别的机器带过来的配置，或者 IDEA 新建工程时默认选了高版本。

解决：按 3.4 的表格四处对齐到 8。特别注意Modules→Sources里的 Language level，这一处最容易被忽略，因为它默认显示Project default，但如果之前被手动改过，就不会跟随项目级。

4.3 现象：Cannot start compilation: the output path is not specified

原因：模块没有编译输出目录，通常是.idea配置丢失或模块是手动导入的。

解决：Project Structure→Project→Project compiler output填一个路径。填完检查Modules→Paths里Compiler output是否自动继承。如果没继承，手动勾Use module compile output path并填路径。

4.4 现象：Maven 工程右侧没有 Maven 面板，依赖全部标红

原因：pom.xml没有被识别为 Maven 项目。

解决：右键pom.xml→Add as Maven Project。如果菜单里没有这一项，去Settings→Build, Execution, Deployment→Build Tools→Maven确认 Maven 的Maven home path和User settings file配置正确。配置完点右侧 Maven 面板的刷新按钮重新导入。

4.5 现象：改了配置，Run 出现了，但一跑就报Command line is too long

原因：Windows 命令行长度限制，Maven 工程依赖多的时候 classpath 拼出来超长。

解决：在工程根目录的.idea/workspace.xml里找到<component name="PropertiesComponent">，加一行<property name="dynamic.classpath" value="true" />。或者直接在 Run Configuration 的Shorten command line下拉框里选JAR manifest。这个坑在 jeecgboot 这种依赖多的工程里特别常见。

5. 进阶：用 Maven 导入和 .idea 清理固化这套流程

配置改完之后，怎么确认这套流程以后不会再翻车？我一般会做两件事：一是用 Maven 重新导入代替手动配置，二是把.idea的清理动作固化下来。

先说 Maven 导入。与其手动一个个标 Sources、绑 SDK，不如让 Maven 帮你做。关掉工程，删掉.idea，用 IDEA 的Open打开pom.xml所在目录，选择Open as Project。IDEA 会读pom.xml里的<maven.compiler.source>和<maven.compiler.target>，自动把 Language Level 设成对应版本。前提是pom.xml里这两个属性写对了：

<properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>

source和target控制编译时的源码版本和字节码版本，encoding控制源文件编码，三个都建议显式写死。这样无论谁 clone 下来，IDEA 导入后 Language Level 都会自动对齐到 8，不用手动改四处。多模块工程在父pom.xml里写一次，子模块继承即可。

再说.idea清理。.idea目录里存的是本机相关的配置，包括 SDK 路径、输出路径、Run Configuration。这些路径在不同机器上大概率不一样，所以正规做法是把.idea加进.gitignore，不提交到仓库。但很多教程工程会把.idea一起打包，导致别人打开时 SDK 路径指向一个不存在的目录，于是又回到「右键没有 Run」的起点。

我自己的习惯是：拿到一个带.idea的工程，先看Project Structure里 SDK 是不是红的或者<No SDK>，是的话直接删.idea重新导入。删之前把workspace.xml里可能有用的 Run Configuration 备份一下，不过大多数情况下重新配一遍也就两分钟的事。

验证配置是否彻底正确，有个简单办法：File→Invalidate Caches / Restart→Invalidate and Restart。清完缓存重启，如果右键main方法 Run 还在，Sources 图标还是蓝的，SDK 没掉，说明配置已经写进模块文件，稳了。如果重启后 Run 又没了，说明之前的配置只存在内存里没落盘，多半是.idea目录权限有问题或者工程在只读盘上。

从那以后我每次新拉一个 Java 工程，都强制走一遍「删 .idea → Open as Project → 等 Maven 导入 → 检查四处 Java 版本」这个流程，再也没被右键没有 Run 卡过。希望帮到你。

本文还有配套的精品资源，点击获取