JAVA PROJECT WORKBENCH / macOS

把熟悉的 Run
带出 IDE。

读取 IntelliJ IDEA 的运行配置,在一个轻巧工作台里构建、启动 Java 服务、跑 JUnit,并查看进程日志与端口。

macOS 13+Apple Silicon / Intel本机 JDK
IdeaLightRun · 本地工作台示意

sample-api

Maven · JDK 21 · 3 modules

⌥ main

运行配置从项目读取

OrdersApplication

类型
Spring Boot
模块
backend
JDK
21
状态
可运行
网页演示 · 未启动进程
$ 选择配置并点击 Run,查看界面状态示例。
$ 本页面不读取项目文件,也不会运行 Java。
交互原型 · 并非实机截图;配置选择与状态按钮只演示页面,不会执行构建或启动 JVM。

从配置到进程,
少一层 IDE 来回切换。

面向已经在 IntelliJ IDEA 中配置好项目的开发者。它读取并执行支持的配置,重点放在启动、停止、构建和观察运行状态。

CONFIG / 01

沿用 IDEA Run Configuration

读取主类或 JAR 路径、模块、JDK、VM 与程序参数、Spring Profile、环境变量和工作目录。

不要求打开 IDEA
BUILD / 02

同一处构建项目

项目识别为 Maven 或 Gradle 后,可构建、重新构建和清理;正在执行的构建可以停止或强制结束。

按项目串行执行
RUN / 03

运行多种配置

支持 Application、Spring Boot、Maven、JUnit、已构建 JAR,以及可解析的 Compound 配置。

能力状态明确显示
TEST / 04

直接执行 JUnit

从模块、类、方法、包或测试目录选择测试目标,交给 Maven Surefire 或 Gradle Test 运行。

结果与日志留在工作台
OBSERVE / 05

从日志看到端口

每个运行进程有自己的控制台与状态;应用只读本机监听端口并在进程退出后停止探测。

Run · Stop · Restart
HOT SWAP / 06

选择性方法体热更新

可选地监视源码变化并更新已加载类的方法体;结构变化会显示需要重启,而不是报成成功。

默认关闭

沿用项目现状,三步进入运行态。

开始前确认项目里已有可运行配置和对应的 JDK。IdeaLightRun 不会替你生成 IDE 配置。

准备 / macOS

安装应用并授权项目目录

下载通用 ZIP,把应用拖入「应用程序」。首次读取桌面、文稿或下载目录时,macOS 可能询问文件访问权限。

添加 / 项目

扫描已有配置

把项目文件夹加入侧栏。应用根据项目中的 IDEA 配置与构建文件列出可运行目标和诊断信息。

执行 / 观察

Run、查看,再停止或重启

选择配置后运行。通过控制台查看日志,在状态栏查看进程状态与本机端口。

先看清支持范围。

不支持的选项会标记或拒绝执行,避免静默改跑另一种命令。

环境与项目

  • 需要 macOS 13+ 和本机 JDK;Apple Silicon 与 Intel 使用通用版本。
  • Application、Spring Boot、Maven、JUnit 通常要求 Maven 或 Gradle 项目;JAR Application 可直接运行已构建的 JAR。
  • Gradle 类型的 IDEA 直接 task 运行配置目前被识别为 PLANNED,不由本版接管。
  • JUnit 的 Tags 与 Unique ID 目标不支持;部分 Maven 自定义路径和选项会被拒绝。

热更新不是结构性重定义

  • 内置 HotSwap 仅承诺更新已加载类的方法体。
  • 新增/删除类、字段或继承结构变化通常需要重启;Spring Bean 定义变更也不会由内置后端自动刷新。
  • 热更新按配置单独开启,默认关闭;第三方后端的实际效果由其自身能力决定。
  • Compound 成员变化需要重启整个组合。
本机工作,网络按需使用

项目扫描、构建与进程管理在本机进行,不上传项目或机器信息。除你主动点击「检查更新」外,应用不会为更新而联网或常驻后台。

常见问题

它会取代 IntelliJ IDEA 吗?

不会。它读取 IDEA 已保存的运行配置,把构建和运行流程放到独立工作台;编辑代码仍可使用你习惯的编辑器。

所有 IDEA 配置都可以运行吗?

不能。应用支持列出的 Application、Spring Boot、Maven、JUnit、JAR 和可解析 Compound 配置。Gradle task 配置及某些特殊字段会显示为计划支持或不支持。

热更新能替换字段或新增类吗?

内置 HotSwap 只更新方法体。字段、方法签名、继承结构等变化由 JVM 拒绝,需要重启。

它会把项目文件发到云端吗?

不会。项目解析、编译、运行与端口查询在本机执行;检查更新只有你主动触发时才联网。

把下一次 Run 放到轻工作台里。

macOS 13+ · 通用二进制 · 由你已有的 JDK 和项目工具链执行。

下载 IdeaLightRun ↗

作者的其他项目

作者主页 ↗