Activiti-modeler汉化全攻略：从零开始实现中文版流程设计器（附完整配置文件）

原创

于 2026-02-28 06:06:38 发布 · 965 阅读

Activiti Modeler 深度汉化实战：从源码解析到界面完全中文化的完整指南

如果你正在一个企业级应用里集成工作流引擎，Activiti 大概率是你的候选方案之一。它的 Modeler 设计器是个好东西，拖拖拽拽就能画出流程图，但那个满屏英文的界面，拿给国内业务团队用，每次都要解释“User Task”是用户任务，“Exclusive Gateway”是排他网关，实在有点影响效率。几年前我第一次接手一个流程平台项目时，就遇到了这个痛点。当时网上资料零散，官方文档对汉化一笔带过，只能自己啃源码、翻 JSON 文件。折腾了两天，终于让整个设计器界面变成了亲切的中文。今天我就把这段经历里积累的经验、踩过的坑，以及最终验证可行的完整方案，系统地分享给你。无论你是刚接触 Activiti 的新手，还是正在为团队寻找流程设计器本地化方案的老手，这篇文章都能帮你绕过弯路，高效实现一个真正可用的中文版流程设计器。

我们聚焦于 Activiti 5.22.0 版本，这是目前许多存量项目仍在使用的稳定版本。整个过程不仅仅是替换几个文字那么简单，它涉及前端静态资源整合、核心配置文件汉化、后端服务适配以及权限调整等多个层面。我会带你一步步走通，并提供经过验证的完整配置文件，你可以直接拿来用。

1. 环境准备与基础资源整合

在开始汉化之前，我们需要一个能正常运行 Activiti Modeler 的基础环境。这就像装修房子，得先有毛坯房。很多教程直接从汉化讲起，忽略了环境搭建的细节，导致读者在后面步骤卡住。这里我会结合 Spring Boot 项目，这是目前最主流的集成方式。

首先，去 Activiti 官网下载 activiti-5.22.0.zip 源码包。解压后，你会看到 war 目录下的 activiti-explorer.war 文件，这里面就包含了我们需要的设计器前端资源。

在你的 Spring Boot 项目的 src/main/resources/static 目录下，创建 activiti 文件夹（用于资源归类，避免污染根目录），然后从 activiti-explorer.war 中提取以下关键内容：

static/activiti/
├── diagram-viewer/    # 流程图查看器（用于流程跟踪，非本次核心但一并集成）
├── editor-app/        # 设计器核心应用（重中之重）
└── modeler.html       # 设计器入口页面

同时，不要忘记一个至关重要的文件：stencilset.json。它定义了设计器左侧面板的所有图形元素（如任务、网关）及其属性。这个文件通常需要从 activiti-modeler 的 JAR 包或在线示例中获取。我建议你直接使用我提供的已初步汉化的版本作为起点，放在 resources 目录下（非 static），因为后端控制器需要读取它。

前端配置关键一步：修改 editor-app/app-cfg.js 文件，将其中的 serviceRoot 指向你的后端 API 地址。默认它可能指向一个不存在的上下文路径。

// editor-app/app-cfg.js 片段
if (typeof ACTIVITI.CONFIG == 'undefined') {
    ACTIVITI.CONFIG = {
        'contextRoot' : '/service', // 根据你的后端控制器映射路径修改
    };
}

后端依赖方面，在 pom.xml 中引入必要的库。除了基本的 Spring Boot Starter，重点是 Activiti 的相关模块：

<properties>
    <activiti.version>5.22.0</activiti.version>
</properties>

<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Activiti 核心与 Spring 集成 -->
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-spring-boot-starter-basic</artifactId>
        <version>${activiti.version}</version>
    </dependency>

    <!-- 模型设计器模块（必须） -->
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-modeler</artifactId>
        <version>${activiti.version}</version>
    </dependency>

    <!-- 数据库驱动（以MySQL为例） -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </depen

标签