中国 帮助

本地开发与联调方案

这一页解决用户最直接的那个抱怨: 总不能我写点东西,就重新打包 → 上传 → 安装嘛。 先给结论:日常改代码不需要走完整上架流程。平台已经具备运行期热加载能力, 问题只在于"怎么把新产物递进去"。这一页给出四条可执行的路径,每条写清适

本地开发与联调方案
封面

> 本文整理自平台文档 docs/wujies/5.x/platform/plugin/local-dev-against-remote.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-1b97ac8bd9bf-cover.svg)

这一页解决用户最直接的那个抱怨:

> 总不能我写点东西,就重新打包 → 上传 → 安装嘛。

先给结论:日常改代码不需要走完整上架流程。平台已经具备运行期热加载能力, 问题只在于"怎么把新产物递进去"。这一页给出四条可执行的路径,每条写清适合什么场景 / 步骤 / 命令 / 局限,以及一条明确的不可行说明。

我改了什么走哪条路一次回路多长
插件前端 Vue[方案 A](#方案-a全本地跑宿主)(本地宿主)或 [方案 B](#方案-b远程宿主--本地产物) 的 B-1秒级(重建 ESM → 刷新浏览器)
插件后端 Java,宿主开了 dev-mode[方案 B-2](#方案-b远程宿主--本地产物)(mvn compile + POST /app/dev/reload / watch)—— 推荐秒级:编译 → 自动/手动重载,宿主不重启
插件后端 Java,宿主没有 dev-mode方案 B-2 的旧做法(上传包 → 对同一 versionId 重复 deploy),或用 [方案 D](#方案-d一条命令的打包--上传--热加载脚本) 压成一条命令分钟级,不重启宿主
插件后端 Java,在本地开发、不连线上数据[方案 A](#方案-a全本地跑宿主)(沙箱 / 本地宿主)分钟级
只想改前端、宿主在远端[方案 C](#方案-c为什么不能指向本地-vite-dev-server) —— 不可行,别试—
宿主自己的代码(wujies-admin / wujies-platform)不在本页范围,见[本地联调](/docs/wujies/5.x/platform/plugin/backend/local-dev) §三、§四Vite 热更新 / 重建 jar

[本地联调](/docs/wujies/5.x/platform/plugin/backend/local-dev) 已经讲清了三条链路(沙箱 / 插件前端 / 宿主前端)、 前置条件、端口、plugins-dist 与 active-plugins.txt 的关系、以及"怎么确认插件真的加载了"。 本页只补它没有的那部分:对标 Halo / NiuCloud 的做法,给出"远程宿主 + 本地代码"的 四条路径与一条命令的自动化脚本。两页互补,不重复。

新建骨架、本地安装、热加载、打开发包都搬进了 「开发工具 → 插件开发」,不需要再手敲 curl。 第一次做插件请直接看[快速开始](/docs/wujies/5.x/platform/plugin/quickstart),页面细节见[可视化开发台](/docs/wujies/5.x/platform/plugin/console)。 本页保留为原理与兜底方案:为什么热加载只能管后端、远程宿主时前端产物怎么过去、 没有 dev-mode 的旧宿主怎么办。

新增 POST /app/dev/install(权限 app:dev:install)与页面按钮:把开发包落位到宿主, 执行迁移、登记 -dev 版本、同步菜单,并直接加载插件工程的 target/classes。 它对齐了 Niushop「应用开发 → 插件开发 → 本地安装」的体验,同时保持 Wujies 的 -dev 版本 不与正式目录混在一起。

与上一版方案的关键区别:不再把源码挂进宿主 Maven 模块,也不生成 wujies-plugin-local POM、不改宿主任何 POM、不要求重启宿主。宿主用独立类加载器 直接读插件仓库的编译输出(Halo 模型),前端由 Vite 从插件仓库的 frontend/dist 提供。见[快速开始](/docs/wujies/5.x/platform/plugin/quickstart) 与[可视化开发台](/docs/wujies/5.x/platform/plugin/console#本地安装)。

开关 app-market.plugin-runtime.dev-mode(默认 false)+ POST /app/dev/reload 补上了 「把本地产物递进宿主」的入口。2026-10-22 起,这条路径从"只吃 jar"扩展为直接吃 target/classes,并新增 watch 自动重载 —— 于是"改一行后端代码"的回路压成了 mvn compile → 自动/手动重载,不需要打包,也不需要重启宿主。 ⚠️ 它是开发专用、默认关闭、且绕过签名校验 —— 什么时候能用、代价是什么,B-2 里逐条写明。 平台仍然缺的是[远程应用 HMR](#五还缺什么)。

---

一、先看别人怎么做:Halo 与 NiuCloud

用户点名要参考这两家。下面每一条都是查到的,附来源;查不到的地方明说「未查到」。

### 1.1 Halo:有真正的 development 运行模式,插件从目录加载

Halo 的插件体系建在 PF4J 上,并且明确区分运行模式。源码里的配置项:

// run/halo/app/plugin/PluginProperties.java
/** Runtime Mode:development/deployment. */
private RuntimeMode runtimeMode = RuntimeMode.DEPLOYMENT;

/** ... In the development mode, you can specify the plugin path as the project directory. */
private List<Path> fixedPluginPath = new ArrayList<>();

/** Extended Plugin Class Directory. */
private List<String> classesDirectories = new ArrayList<>();

/** Extended Plugin Jar Directory. */
private List<String> libDirectories = new ArrayList<>(List.of("build/libs"));
问题Halo 的答案来源
有没有 dev 模式有。属性前缀 halo.plugin,runtime-mode 取 development / deployment(PF4J 的 RuntimeMode)[PluginProperties.java](https://github.com/halo-dev/halo/blob/main/application/src/main/java/run/halo/app/plugin/PluginProperties.java)
插件从哪加载dev 模式从目录,正式模式从 jar。加载器是二选一的:DevPluginLoader(isApplicable = Files.isDirectory(pluginPath))优先,否则 JarPluginLoader[DevPluginLoader.java](https://github.com/halo-dev/halo/blob/main/application/src/main/java/run/halo/app/plugin/DevPluginLoader.java)
目录模式怎么生效classpath 从插件的 build/classes + build/libs 拼;fixedPluginPath 让插件根目录直接指向工程目录,而不是拷贝到 plugins/[PluginProperties.java](https://github.com/halo-dev/halo/blob/main/application/src/main/java/run/halo/app/plugin/PluginProperties.java) · [PluginAutoConfiguration.java](https://github.com/halo-dev/halo/blob/main/application/src/main/java/run/halo/app/plugin/PluginAutoConfiguration.java)(createPluginRepository 里 DefaultDevelopmentPluginRepository 的 setFixedPaths)
改了 Java 要不要重启不要。改完执行 ./gradlew reloadPlugin 应用改动;不重启 Halo 进程[DevTools 文档](https://docs.halo.run/developer-guide/plugin/basics/devtools.md)
能不能自动重载能。./gradlew watch 监视 src/main/ 并自动重新加载(watchDomains 可加目录,默认排除 build/、src/main/resources/ui/ 等构建产物)[DevToo

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-1b97ac8bd9bf-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容