开发中经常遇到的 "Artifacts" 到底是什么意思？

Posted on 2026-02-25 09:42 steve.z 阅读(4419) 评论(0) 收藏举报

什么是 Artifacts？基础概念

Artifact（工件）是软件开发中一个非常重要的概念。简单来说，Artifact 就是开发过程中产生的各种产物——从源代码经过编译、构建、打包等步骤后生成的最终结果。

想象一下：你写了一份 Java 代码，编译器把它转换成了可以运行的 .jar 文件，这个 .jar 文件就是一个 artifact。你在网页上写了 HTML 和 CSS，最终生成了一个网站，这个网站也是一个 artifact。

Artifacts 在不同场景中的含义

1. Maven（Java 构建工具）中的 Artifacts

Maven 是 Java 开发中最常用的构建工具。在 Maven 中，artifact 有非常明确的定义。

Maven Artifact 的三个核心要素

要素	说明	例子
GroupId	组织/公司的唯一标识	`com.example`
ArtifactId	项目的唯一名称	`my-app`
Version	版本号	`1.0.0`

当这三个要素组合在一起时，就唯一标识了一个 artifact。

实际例子

<!-- pom.xml 文件中 -->
<groupId>com.example</groupId>
<artifactId>my-app</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>

这段配置说明：

这个项目属于 com.example 组织
项目名称是 my-app
当前版本是 1.0.0
最终会打包成一个 JAR 文件：my-app-1.0.0.jar

Maven 生成的 Artifacts 类型

类型	文件扩展名	用途
JAR	`.jar`	Java 应用程序或库
WAR	`.war`	Web 应用程序（放在 Tomcat 等服务器中运行）
EAR	`.ear`	企业级应用程序
POM	`.pom`	项目配置文件本身

2. Gradle 中的 Artifacts

Gradle 是另一个流行的 Java 构建工具，功能比 Maven 更强大，配置也更灵活。

// build.gradle 文件
group = 'com.example'
archivesBaseName = 'my-app'
version = '1.0.0'

jar {
    // 配置 JAR 文件的属性
    manifest {
        attributes 'Main-Class': 'com.example.Main'
    }
}

Gradle 中的 artifact 概念与 Maven 类似，但配置方式更简洁。

3. IntelliJ IDEA 中的 Artifacts

在 IntelliJ IDEA（一个流行的 Java IDE）中，artifact 是你配置项目如何被打包和部署的方式。

如何在 IntelliJ IDEA 中配置 Artifacts

打开菜单：File → Project Structure → Artifacts
点击 + 按钮添加新的 artifact
选择 artifact 类型：
- JAR - 生成可执行的 JAR 文件
- WAR - 生成 Web 应用程序包
- EAR - 生成企业应用程序包
- Exploded - 生成未压缩的目录结构

实际场景

假设你有一个 Spring Boot 应用，你可以配置一个 artifact，让 IDE 自动将你的代码、依赖库和资源文件打包成一个 my-app-1.0.0.jar，然后你就可以直接运行：

java -jar my-app-1.0.0.jar

4. Android Studio 中的 Artifacts

在 Android Studio（Android 应用开发工具）中，artifact 通常指的是最终生成的应用程序包。

Artifact 类型	文件扩展名	说明
APK	`.apk`	Android 应用包，可以直接安装到手机上
AAB	`.aab`	Android App Bundle，用于上传到 Google Play Store

当你点击"Build" → "Build APK"时，Android Studio 就会生成一个 artifact（APK 文件）。

5. CI/CD 流程中的 Artifacts

在 持续集成/持续部署（CI/CD） 流程中，artifact 指的是构建过程中产生的所有产物。

GitHub Actions 中的例子

name: Build and Upload Artifact

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Build
        run: mvn clean package
      
      - name: Upload Artifact
        uses: actions/upload-artifact@v2
        with:
          name: my-app-jar
          path: target/my-app-1.0.0.jar

这个工作流：

检出代码
使用 Maven 构建项目
上传 artifact（JAR 文件）到 GitHub

之后，你可以从 GitHub 的 Actions 页面下载这个 artifact。

6. Claude 中的 Artifacts

在 Claude AI 中，artifact 是一个新概念，指的是 Claude 生成的各种内容。

Claude 中的 Artifact 包括

类型	例子
代码片段	Python 脚本、JavaScript 代码、HTML 页面
文本文档	Markdown 文档、技术说明书
网站设计	完整的 HTML + CSS 网页
配置文件	Docker 配置、Kubernetes YAML 等

当你要求 Claude 生成代码或文档时，Claude 会在一个独立的窗口中显示这些内容，这就是 artifact。这样做的好处是：

代码和对话分离，更清晰
你可以直接复制、编辑或下载 artifact
便于查看完整的代码或文档

Artifacts 的生命周期：从代码到产物

让我用一个完整的例子来展示 artifact 的整个生命周期。

场景：开发一个 Java Web 应用

第 1 步：编写源代码

// src/main/java/com/example/HelloApp.java
package com.example;

public class HelloApp {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

第 2 步：配置构建工具（Maven）

<!-- pom.xml -->
<project>
    <groupId>com.example</groupId>
    <artifactId>hello-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

第 3 步：构建项目

mvn clean package

这个命令会：

清理之前的构建文件
编译源代码
运行测试
打包生成 artifact：target/hello-app-1.0.0.jar

第 4 步：使用 Artifact

java -jar target/hello-app-1.0.0.jar
# 输出：Hello, World!

或者，如果其他项目需要这个库，可以将它上传到 Maven 仓库，其他人就可以在他们的 pom.xml 中引用：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>hello-app</artifactId>
    <version>1.0.0</version>
</dependency>

为什么 Artifacts 很重要？

1. 版本管理

Artifact 有明确的版本号，便于追踪和管理不同版本的代码。

2. 依赖管理

通过 artifact 的 GroupId、ArtifactId 和 Version，可以精确地指定项目依赖的库和版本。

3. 可重复构建

同样的源代码和配置，每次构建都会生成相同的 artifact，确保一致性。

4. 部署和分发

Artifact 是可以直接运行或部署的产物，不需要源代码。

5. 团队协作

团队成员可以共享 artifact，而不必每个人都编译源代码。

常见问题解答

Q1：Source Code（源代码）和 Artifact（工件）有什么区别？

对比项	源代码	Artifact
格式	人类可读的代码文件（`.java`、`.py` 等）	编译/打包后的产物（`.jar`、`.apk` 等）
可执行性	不能直接运行，需要编译	可以直接运行或部署
大小	通常较小	通常较大（包含编译后的字节码和依赖）
用途	开发和维护	部署和运行

Q2：为什么需要 Artifact，直接运行源代码不行吗？

不行，因为：

计算机不能直接理解高级编程语言
需要通过编译器将源代码转换为机器可以理解的格式
Artifact 包含了所有必要的依赖库，便于分发

Q3：一个项目可以生成多个 Artifacts 吗？

可以的。例如，一个 Maven 项目可以配置生成多个 artifact：

一个 JAR 文件（库）
一个 WAR 文件（Web 应用）
一个 ZIP 文件（包含文档和资源）

Q4：Artifact 可以删除吗？

可以。Artifact 可以随时删除和重新生成，因为它们是由源代码构建而来的。但如果 artifact 已经被部署到生产环境，删除可能会导致问题。

Q5：Maven 仓库（Repository）是什么？

Maven 仓库是一个存储 artifact 的中央库。最著名的是 Maven Central Repository（中央仓库）。当你在 pom.xml 中声明依赖时，Maven 会自动从仓库下载相应的 artifact。

实战小练习

练习 1：创建你的第一个 Maven Artifact

# 创建一个新的 Maven 项目
mvn archetype:generate -DgroupId=com.mycompany -DartifactId=my-first-app -DarchetypeArtifactId=maven-archetype-quickstart

# 进入项目目录
cd my-first-app

# 构建项目
mvn clean package

# 查看生成的 artifact
ls target/
# 你会看到 my-first-app-1.0-SNAPSHOT.jar

练习 2：在 IntelliJ IDEA 中配置 Artifact

创建一个新的 Java 项目
打开 File → Project Structure → Artifacts
点击 + → JAR → From modules with dependencies
选择你的主类
点击 Build → Build Artifacts → Build
在 out/artifacts/ 目录下找到生成的 JAR 文件

总结

概念	简单理解	类比
Source Code（源代码）	你写的代码	烹饪食材
Build Process（构建过程）	编译、打包等步骤	烹饪过程
Artifact（工件）	最终的可执行产物	做好的菜肴
Deployment（部署）	将 artifact 放到服务器运行	上菜

记住：Artifact 就是你的代码经过编译和打包后的最终产物，它是可以直接运行或部署的。

无论你是在使用 Maven、Gradle、Android Studio 还是 Claude，artifact 的核心概念都是一样的——它是开发过程的最终成果。

刷新页面返回顶部

Z. Steve

公告