Eclipse 运行配置(Run Configuration)

以下是 Eclipse 中 运行配置（Run Configurations） 的完整实用指南（适用于 Eclipse 2024/2025 版本，Java 项目为主，也适用于普通 Java Application、Spring Boot、JUnit、Tomcat 等）。

方式	操作
最快	点击主工具栏绿色运行按钮旁的小三角 ▼ → Run Configurations…
菜单	Run → Run Configurations…
快捷键	先按一次 Ctrl + F11（运行上一次），再点工具栏小三角 → Run Configurations
右键 Main 类	右键有 main 方法的类 → Run As → Run Configurations…
菜单栏	Window → Show View → Run Configurations（很少用）
Debug 配置	点击红色虫子（Debug）旁的小三角 → Debug Configurations…

类型	典型用途	常用设置项
Java Application（最常用）	普通带 main() 方法的 Java 程序	Main class、Program arguments、VM arguments
JUnit 4 / JUnit 5	运行单元测试	Test class、Test method、VM arguments
Spring Boot Application	快速启动 Spring Boot 项目	Main class 自动填好，自动添加 –spring.profiles.active=dev 等
Apache Tomcat	本地启动 Tomcat 服务器	Server location、Deploy path
Application on Server	远程或本地 Tomcat/JBoss/WildFly	选择服务器、添加项目
Remote Java Application	远程调试（Debug 连接到远程 JVM）	Host + Port

打开 Run Configurations → 选中 Java Application → 点击左上角 “New launch configuration” 按钮（或复制已有的）

标签页	关键设置项	举例说明
Main	Main class	com.example.DemoApplication
Arguments	Program arguments（程序参数）	`input.txt 8080`（main 方法 String[] args）
	VM arguments（JVM 参数）	`-Xmx2g -Dfile.encoding=UTF-8 -Dspring.profiles.active=prod`
	Working directory（工作目录）	默认是项目根目录，可改成 `${project_loc}/config`
Classpath	User Entries	一般不用改，Maven 项目会自动包含所有依赖
Environment	环境变量	添加 `JAVA_HOME`, `PATH` 等
Common	保存到 launch configuration 文件	勾选 “Shared launch configuration” 可以 .launch 文件形式提交 git

小技巧：

  -ea -Xmx4g -Xms2g -XX:+HeapDumpOnOutOfMemoryError
  -Duser.timezone=Asia/Shanghai
  -Dspring.profiles.active=dev

需求	操作方法
快速复制一份配置	选中已有配置 → 工具栏 “Duplicate” 按钮（Ctrl + Alt + C）
改个参数就想重新运行	不要点绿色运行按钮！直接在 Run Configurations 里点 “Run” 或 “Debug”
想让每次运行都自动使用最新的配置	工具栏绿色按钮旁边的小三角 → Run Configuration → Always launch the selected configuration
运行时改端口不重启（Spring Boot）	VM arguments 里加 `-Dserver.port=8081`
调试时跳过某些包	在 Debug Configurations → Java Application → Source 标签页排除不需要的包
一键运行多个配置（比如先启动 DB、再启动服务）	用 Launch Group（新建 → Launch Group → 添加多个配置）

问题	解决办法
运行后端口被占用	VM arguments 加 `-Dserver.port=新端口` 或改 application.yml
找不到 main 类	Main 标签页点击 “Search…” 重新选类
控制台乱码	VM arguments 加 `-Dfile.encoding=UTF-8` 或 `-Dsun.stdout.encoding=UTF-8`
想每次运行都重新编译	Project → Build Automatically（默认打开）或 Run Configurations → Common → Launch operation → Always build before launch
想把配置共享给团队	勾选 “Common → Shared launch configuration”，会生成 .launch 文件，提交 git 即可

项目名-环境-用途
例如：
MyApp-dev-本地运行
MyApp-test-测试环境
MyApp-prod-生产参数验证
MyApp-Debug-带远程调试端口

这样团队成员打开项目后，Run Configurations 里一目了然，直接点对应的配置就能跑。

有具体想运行什么项目（普通 Java、Spring Boot、带参数、Tomcat、单元测试等），直接告诉我，我给你现成的配置模板或 VM arguments。

归档