在使用IDEA进行项目开发时项目的构建与打包是非常重要的环节。通过构建和打包我们可以将项目代码转化为可执行文件方便部署和运行。这一小节我们就来详细探讨如何使用IDEA完成项目的构建和打包让你能够一键生成可执行文件。构建和打包的核心技术点构建和打包的概念在软件开发中构建Build和打包Package是两个紧密相关但又有所不同的概念。简单来说构建是将源代码转化为可运行的程序的过程它包括编译代码、处理资源文件、解决依赖关系等一系列操作。而打包则是将构建好的程序及其依赖项整合到一个或多个文件中方便分发和部署。举个例子假如你写了一个Java程序构建的过程就是把你写的Java代码编译成字节码文件.class文件而打包就是把这些字节码文件和相关的资源文件如配置文件、图片等打包成一个JAR文件或者WAR文件。IDEA项目的构建和打包流程IDEA支持多种构建工具其中最常用的是Maven和Gradle。下面我们分别介绍使用这两种工具进行项目构建和打包的基本流程。Maven构建和打包流程配置pom.xml文件Maven使用pom.xml文件来管理项目的依赖和构建配置。在这个文件中你需要指定项目的坐标groupId、artifactId、version、依赖项、插件等信息。执行构建命令在IDEA中你可以通过Maven工具窗口执行各种Maven命令如clean、compile、package等。clean命令用于清理项目的构建输出目录compile命令用于编译项目的源代码package命令用于将项目打包成可分发的文件。查看打包结果打包完成后你可以在项目的target目录下找到生成的打包文件如JAR文件或WAR文件。Gradle构建和打包流程配置build.gradle文件Gradle使用build.gradle文件来管理项目的构建配置。在这个文件中你需要指定项目的插件、依赖项、任务等信息。执行构建任务在IDEA中你可以通过Gradle工具窗口执行各种Gradle任务如clean、build、assemble等。clean任务用于清理项目的构建输出目录build任务用于编译项目的源代码并打包assemble任务用于只打包不进行测试。查看打包结果打包完成后你可以在项目的build/libs目录下找到生成的打包文件。使用Maven进行项目构建和打包的步骤1. 创建Maven项目首先打开IDEA选择File-New-Project在弹出的窗口中选择Maven然后按照向导完成项目的创建。在创建过程中你可以选择是否使用Archetype模板以及指定项目的坐标和存储位置。2. 配置pom.xml文件打开项目的pom.xml文件添加项目的依赖项和插件。以下是一个简单的pom.xml文件示例projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0-SNAPSHOT/versiondependencies!-- 添加项目的依赖项 --dependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.13.2/versionscopetest/scope/dependency/dependenciesbuildplugins!-- 添加Maven打包插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-jar-plugin/artifactIdversion3.2.0/versionconfigurationarchivemanifestmainClasscom.example.Main/mainClass/manifest/archive/configuration/plugin/plugins/build/project在这个示例中我们添加了JUnit依赖项并配置了Maven的JAR打包插件指定了项目的主类。3. 执行打包命令打开IDEA的Maven工具窗口找到Lifecycle节点双击package命令。Maven会自动下载项目的依赖项编译源代码并将项目打包成一个JAR文件。4. 查看打包结果打包完成后在项目的target目录下找到生成的JAR文件。你可以使用命令行工具运行这个JAR文件验证打包是否成功。例如在命令行中执行以下命令java-jartarget/my-project-1.0-SNAPSHOT.jar使用Gradle进行项目构建和打包的步骤1. 创建Gradle项目同样打开IDEA选择File-New-Project在弹出的窗口中选择Gradle然后按照向导完成项目的创建。在创建过程中你可以选择项目的语言如Java、Kotlin等和构建脚本的类型如Groovy或Kotlin DSL。2. 配置build.gradle文件打开项目的build.gradle文件添加项目的依赖项和任务。以下是一个简单的build.gradle文件示例plugins{idjava}groupcom.exampleversion1.0-SNAPSHOTrepositories{mavenCentral()}dependencies{testImplementationjunit:junit:4.13.2}jar{manifest{attributesMain-Class:com.example.Main}}在这个示例中我们添加了JUnit依赖项并配置了Gradle的JAR任务指定了项目的主类。3. 执行打包任务打开IDEA的Gradle工具窗口找到Tasks节点展开build任务组双击assemble任务。Gradle会自动下载项目的依赖项编译源代码并将项目打包成一个JAR文件。4. 查看打包结果打包完成后在项目的build/libs目录下找到生成的JAR文件。同样你可以使用命令行工具运行这个JAR文件验证打包是否成功。打包配置示例Maven打包配置示例以下是一个更复杂的Maven打包配置示例用于创建一个可执行的JAR文件并包含项目的所有依赖项projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0-SNAPSHOT/versiondependencies!-- 添加项目的依赖项 --dependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.13.2/versionscopetest/scope/dependency/dependenciesbuildplugins!-- 添加Maven打包插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-assembly-plugin/artifactIdversion3.3.0/versionconfigurationdescriptorRefsdescriptorRefjar-with-dependencies/descriptorRef/descriptorRefsarchivemanifestmainClasscom.example.Main/mainClass/manifest/archive/configurationexecutionsexecutionidmake-assembly/idphasepackage/phasegoalsgoalsingle/goal/goals/execution/executions/plugin/plugins/build/project在这个示例中我们使用了Maven的maven-assembly-plugin插件将项目的所有依赖项打包到一个JAR文件中。Gradle打包配置示例以下是一个Gradle打包配置示例用于创建一个可执行的JAR文件并包含项目的所有依赖项plugins{idjava}groupcom.exampleversion1.0-SNAPSHOTrepositories{mavenCentral()}dependencies{testImplementationjunit:junit:4.13.2}taskfatJar(type:Jar){manifest{attributesMain-Class:com.example.Main}baseNameproject.name-allfrom{configurations.runtimeClasspath.collect{it.isDirectory()?it:zipTree(it)}}with jar}在这个示例中我们定义了一个名为fatJar的自定义任务将项目的所有依赖项打包到一个JAR文件中。解决打包过程中常见的问题打包失败依赖项下载失败这可能是由于网络问题或者Maven/Gradle仓库配置不正确导致的。你可以检查网络连接或者尝试更换Maven/Gradle的仓库地址。例如在Maven的settings.xml文件中添加国内的镜像仓库mirrorsmirroridaliyunmaven/idmirrorOf*/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors编译错误这可能是由于代码中存在语法错误或者依赖项版本不兼容导致的。你可以检查代码的语法错误或者尝试更新依赖项的版本。文件缺失资源文件缺失这可能是由于Maven/Gradle的资源配置不正确导致的。你可以检查pom.xml或build.gradle文件中的资源配置确保所有需要的资源文件都被正确包含。例如在Maven的pom.xml文件中添加以下配置buildresourcesresourcedirectorysrc/main/resources/directoryincludesinclude**/*.properties/includeinclude**/*.xml/include/includes/resource/resources/build总结通过本小节的学习你已经掌握了使用IDEA进行项目构建和打包的方法包括使用Maven和Gradle进行项目构建和打包的步骤以及打包配置示例。同时你也学会了解决打包过程中常见的问题如打包失败、文件缺失等。掌握了这些内容后下一节我们将深入学习IDEA在项目部署方面的功能进一步完善对本章IDEA项目管理与构建主题的认知。 系列专栏导航 专栏导航 掌握 IntelliJ IDEA从入门到精通的全栈指南其他专栏衔接 《若依框架全攻略从入门到项目实战》 《深入浅出Mybatis》 全面掌握MySQL工具 《深入浅出Maven》 《深入浅出Kafka》 《全面掌握Swagger从入门到实战》 《Lombok高效Java开发的秘密武器完全解读》 博客概览《程序员技术成长导航专栏汇总》建议按系列顺序阅读从基础到进阶逐步掌握核心能力避免遗漏关键知识点全景导航博文系列《一口气学完fastJson》《一文搞懂PageHelper》《一文搞懂MyBatis》 
长河君 · 2026/10/25 1:56:26 · 阅读 1.2k IDEA项目构建与打包：一键生成可执行文件
在使用IDEA进行项目开发时项目的构建与打包是非常重要的环节。通过构建和打包我们可以将项目代码转化为可执行文件方便部署和运行。这一小节我们就来详细探讨如何使用IDEA完成项目的构建和打包让你能够一键生成可执行文件。构建和打包的核心技术点构建和打包的概念在软件开发中构建Build和打包Package是两个紧密相关但又有所不同的概念。简单来说构建是将源代码转化为可运行的程序的过程它包括编译代码、处理资源文件、解决依赖关系等一系列操作。而打包则是将构建好的程序及其依赖项整合到一个或多个文件中方便分发和部署。举个例子假如你写了一个Java程序构建的过程就是把你写的Java代码编译成字节码文件.class文件而打包就是把这些字节码文件和相关的资源文件如配置文件、图片等打包成一个JAR文件或者WAR文件。IDEA项目的构建和打包流程IDEA支持多种构建工具其中最常用的是Maven和Gradle。下面我们分别介绍使用这两种工具进行项目构建和打包的基本流程。Maven构建和打包流程配置pom.xml文件Maven使用pom.xml文件来管理项目的依赖和构建配置。在这个文件中你需要指定项目的坐标groupId、artifactId、version、依赖项、插件等信息。执行构建命令在IDEA中你可以通过Maven工具窗口执行各种Maven命令如clean、compile、package等。clean命令用于清理项目的构建输出目录compile命令用于编译项目的源代码package命令用于将项目打包成可分发的文件。查看打包结果打包完成后你可以在项目的target目录下找到生成的打包文件如JAR文件或WAR文件。Gradle构建和打包流程配置build.gradle文件Gradle使用build.gradle文件来管理项目的构建配置。在这个文件中你需要指定项目的插件、依赖项、任务等信息。执行构建任务在IDEA中你可以通过Gradle工具窗口执行各种Gradle任务如clean、build、assemble等。clean任务用于清理项目的构建输出目录build任务用于编译项目的源代码并打包assemble任务用于只打包不进行测试。查看打包结果打包完成后你可以在项目的build/libs目录下找到生成的打包文件。使用Maven进行项目构建和打包的步骤1. 创建Maven项目首先打开IDEA选择File-New-Project在弹出的窗口中选择Maven然后按照向导完成项目的创建。在创建过程中你可以选择是否使用Archetype模板以及指定项目的坐标和存储位置。2. 配置pom.xml文件打开项目的pom.xml文件添加项目的依赖项和插件。以下是一个简单的pom.xml文件示例projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0-SNAPSHOT/versiondependencies!-- 添加项目的依赖项 --dependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.13.2/versionscopetest/scope/dependency/dependenciesbuildplugins!-- 添加Maven打包插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-jar-plugin/artifactIdversion3.2.0/versionconfigurationarchivemanifestmainClasscom.example.Main/mainClass/manifest/archive/configuration/plugin/plugins/build/project在这个示例中我们添加了JUnit依赖项并配置了Maven的JAR打包插件指定了项目的主类。3. 执行打包命令打开IDEA的Maven工具窗口找到Lifecycle节点双击package命令。Maven会自动下载项目的依赖项编译源代码并将项目打包成一个JAR文件。4. 查看打包结果打包完成后在项目的target目录下找到生成的JAR文件。你可以使用命令行工具运行这个JAR文件验证打包是否成功。例如在命令行中执行以下命令java-jartarget/my-project-1.0-SNAPSHOT.jar使用Gradle进行项目构建和打包的步骤1. 创建Gradle项目同样打开IDEA选择File-New-Project在弹出的窗口中选择Gradle然后按照向导完成项目的创建。在创建过程中你可以选择项目的语言如Java、Kotlin等和构建脚本的类型如Groovy或Kotlin DSL。2. 配置build.gradle文件打开项目的build.gradle文件添加项目的依赖项和任务。以下是一个简单的build.gradle文件示例plugins{idjava}groupcom.exampleversion1.0-SNAPSHOTrepositories{mavenCentral()}dependencies{testImplementationjunit:junit:4.13.2}jar{manifest{attributesMain-Class:com.example.Main}}在这个示例中我们添加了JUnit依赖项并配置了Gradle的JAR任务指定了项目的主类。3. 执行打包任务打开IDEA的Gradle工具窗口找到Tasks节点展开build任务组双击assemble任务。Gradle会自动下载项目的依赖项编译源代码并将项目打包成一个JAR文件。4. 查看打包结果打包完成后在项目的build/libs目录下找到生成的JAR文件。同样你可以使用命令行工具运行这个JAR文件验证打包是否成功。打包配置示例Maven打包配置示例以下是一个更复杂的Maven打包配置示例用于创建一个可执行的JAR文件并包含项目的所有依赖项projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0-SNAPSHOT/versiondependencies!-- 添加项目的依赖项 --dependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.13.2/versionscopetest/scope/dependency/dependenciesbuildplugins!-- 添加Maven打包插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-assembly-plugin/artifactIdversion3.3.0/versionconfigurationdescriptorRefsdescriptorRefjar-with-dependencies/descriptorRef/descriptorRefsarchivemanifestmainClasscom.example.Main/mainClass/manifest/archive/configurationexecutionsexecutionidmake-assembly/idphasepackage/phasegoalsgoalsingle/goal/goals/execution/executions/plugin/plugins/build/project在这个示例中我们使用了Maven的maven-assembly-plugin插件将项目的所有依赖项打包到一个JAR文件中。Gradle打包配置示例以下是一个Gradle打包配置示例用于创建一个可执行的JAR文件并包含项目的所有依赖项plugins{idjava}groupcom.exampleversion1.0-SNAPSHOTrepositories{mavenCentral()}dependencies{testImplementationjunit:junit:4.13.2}taskfatJar(type:Jar){manifest{attributesMain-Class:com.example.Main}baseNameproject.name-allfrom{configurations.runtimeClasspath.collect{it.isDirectory()?it:zipTree(it)}}with jar}在这个示例中我们定义了一个名为fatJar的自定义任务将项目的所有依赖项打包到一个JAR文件中。解决打包过程中常见的问题打包失败依赖项下载失败这可能是由于网络问题或者Maven/Gradle仓库配置不正确导致的。你可以检查网络连接或者尝试更换Maven/Gradle的仓库地址。例如在Maven的settings.xml文件中添加国内的镜像仓库mirrorsmirroridaliyunmaven/idmirrorOf*/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors编译错误这可能是由于代码中存在语法错误或者依赖项版本不兼容导致的。你可以检查代码的语法错误或者尝试更新依赖项的版本。文件缺失资源文件缺失这可能是由于Maven/Gradle的资源配置不正确导致的。你可以检查pom.xml或build.gradle文件中的资源配置确保所有需要的资源文件都被正确包含。例如在Maven的pom.xml文件中添加以下配置buildresourcesresourcedirectorysrc/main/resources/directoryincludesinclude**/*.properties/includeinclude**/*.xml/include/includes/resource/resources/build总结通过本小节的学习你已经掌握了使用IDEA进行项目构建和打包的方法包括使用Maven和Gradle进行项目构建和打包的步骤以及打包配置示例。同时你也学会了解决打包过程中常见的问题如打包失败、文件缺失等。掌握了这些内容后下一节我们将深入学习IDEA在项目部署方面的功能进一步完善对本章IDEA项目管理与构建主题的认知。 系列专栏导航 专栏导航 掌握 IntelliJ IDEA从入门到精通的全栈指南其他专栏衔接 《若依框架全攻略从入门到项目实战》 《深入浅出Mybatis》 全面掌握MySQL工具 《深入浅出Maven》 《深入浅出Kafka》 《全面掌握Swagger从入门到实战》 《Lombok高效Java开发的秘密武器完全解读》 博客概览《程序员技术成长导航专栏汇总》建议按系列顺序阅读从基础到进阶逐步掌握核心能力避免遗漏关键知识点全景导航博文系列《一口气学完fastJson》《一文搞懂PageHelper》《一文搞懂MyBatis》