中国 帮助

本地开发与联调方案

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

本地开发与联调方案
封面

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

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

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

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

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

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

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

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

本页原文的结论是"平台缺三样东西",其中第 ① 条(没有"热加载本地 jar"的入口)已经实现: 开关 app-market.plugin-runtime.dev-mode(默认 false)+ 端点 POST /app/dev/reload。 于是"改一行后端代码"的回路从"打包 → 上传 → 建版本 → 安装"压成了 "重建 jar → 一条命令",见下面[方案 B-2](#方案-b远程宿主--本地产物)。 ⚠️ 它是开发专用、默认关闭、且绕过签名校验 —— 什么时候能用、代价是什么,B-2 里逐条写明。 第 ② ③ 条(从 target/classes 直接加载、远程应用 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/ 等构建产物)[DevTools 文档](https://docs.halo.run/developer-guide/plugin/basics/devtools.md)
怎么起一套开发环境./gradlew haloServer —— 用 Docker 起一个 Halo,把工作目录挂到插件工程的 workplace/(重启不丢数据),并以开发模式把本插件加载进去;控制台 http://localhost:8090/console,默认 admin/admin[DevTools 文档](https://docs.halo.run/developer-guide/plugin/basics/devtools.md)
后端怎么打断点halo { debug = true },再用 IDE attach;suspend = true 可让它在启动时挂起等调试器[DevTools 文档](https://docs.halo.run/developer-guide/plugin/basics/devtools.

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容