> 本文整理自平台文档 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)


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