企业官网建设流程全解析

接手了一个老系统，环境还在用 Eclipse，模板层用的 FreeMarker，可偏偏工作区是在一个不通外网的隔离网段里。平时写.ftl文件都靠记事本硬扛，高亮没有、提示没有，标签拼错一个字母只能在运行时被用户骂回来。另一边，有个模块只有编译后的.class文件，源码已经找不到了，需要反编译出来做问题定位。于是“Eclipse 中离线安装 FreeMarker IDE 插件和 JAD 反编译插件”这个需求就这么来了。

这篇文章面向的主要是三类人：还在维护老项目的开发者、公司有严格网络隔离的团队、以及想在本地虚拟机里离线复现一套 Java 开发环境的朋友。我会把离线安装插件的前置认知、具体操作步骤、会遇到的关键坑和排查方法都写出来，照着做基本能落地。

1. 为什么一定要在 Eclipse 里装这两个插件

1.1 没有 FreeMarker 插件的模板开发就是一场煎熬

FreeMarker 是一种模板引擎，老项目里常拿它生成网页、邮件、配置文件。它的模板文件一般是.ftl后缀，文件内容里混杂着 HTML 标签、FreeMarker 指令（<#if>、<#list>）和${...}插值表达式。如果没有专门编辑器，Eclipse 默认只会把.ftl当成纯文本打开，结果就是：

• 指令没有颜色区分，满屏白字，看一会眼睛就花了。
• 少写一个</#if>很难发现，只能在运行时看报错。
• 变量拼写错了不提示，模板执行到一半才暴露出问题。
• 没法直接跳转到模板引用的 Java 类或变量定义，非常不顺手。

装了 FreeMarker IDE 插件之后，.ftl文件会自动关联到专用编辑器，语法高亮、标签补全、指令匹配、快速定位都能用。对于需要在模板层频繁改需求的场景，这点提升非常明显。

需要说明的是，这里的 FreeMarker IDE 插件指的是 Eclipse 生态里长期存在的社区插件。虽然新项目可能更愿意用 IntelliJ 或者 VSCode 加扩展，但老项目既然锁定在 Eclipse，离线把插件装上是最省事的路线。

1.2 JAD 反编译插件是救场工具，不是抄代码工具

JAD 是一款非常经典的 Java 反编译器，配合 JadClipse 这类 Eclipse 插件，可以在 IDE 里直接打开.class文件查看反编译结果，而不需要切到外部工具。道理很简单：某些模块发布包里有 class 文件，但没有附带源码包。遇到线上问题，在 IDE 里点开看看具体实现，比下载大型图形化反编译工具再手动拖文件高效得多。

有人可能会说“JAD 太老了，新的 CFR 不香吗”。但在隔离内网里，老工具的好处是体积小、依赖少、一个可执行文件就能跑，而且在老 JDK 编译出来的 class 文件上表现相当稳定。对于 Java 8 之前的传统代码，JAD 反编译出来的结果基本能看。所以这个插件不是用来抄代码的，更多是应急查阅。理解了这一点，你才知道为什么还要配置一个外部 jad.exe，而不是装上插件就能直接用。

2. 离线安装前，先把插件的结构和工作原理看懂

2.1 一个 Eclipse 插件包里到底有什么

很多人在离线安装时失败，是因为不明白 Eclipse 插件的整体结构。Eclipse 是一个基于 OSGi 架构的 IDE，插件不是随便丢个 jar 到安装目录就能被识别，它往往由两部分构成：

• plugins目录：存放插件本体，里面是一个个 jar 包或目录，最终加载执行的代码都在这里。
• features目录：存放功能特性描述，相当于一个“插件集合”的安装清单，告诉 Eclipse 这个功能包含哪些插件、版本号是什么。

大部分从插件市场下载的离线安装包，解压后可以看到根目录下就是这两个文件夹。但也有些包会在第一层套一个目录名，比如解压后先看到freemarker-ide-2.0.4文件夹，文件夹内部才是features和plugins。如果你直接把整个外层文件夹丢进了dropins，Eclipse 可能识别不到，因为目录层级不对。

还有一类离线方式是“本地更新站点”。更新站点压缩包里面通常会有content.jar、artifacts.jar、features、plugins等文件。这类包更适合用 Eclipse 的 “Install New Software” 进行本地安装。判断包是哪种结构，解压之后肉眼看一下根目录就能分辨。

2.2 离线安装的几种常见路线对比

针对 Eclipse 插件离线安装，我曾经整理过几条路线，各有适用场景，大家可以根据自己的环境选：

我个人最常用的是dropins，理由很直接：它足够干净，每个插件放进独立子目录，出问题时只要把整个子目录删掉，就能还原到装插件之前的状态。直接丢进plugins的方式虽然最简单，但卸载时还要手动确认 jar 依赖关系，踩两次坑之后我就不怎么用了。

2.3 版本匹配判断标准

Eclipse 插件不像普通软件那样随便双击就能装，它和 JDK、Eclipse 之间存在版本匹配问题。首先要确认当前 Eclipse 是哪个版本。只看启动画面的图标还不够，最稳妥的方式是在 Eclipse 的About Eclipse里查看版本号与 Build id。

版本匹配主要看三点：

1. 插件的最低运行 Eclipse 版本。有些老插件是基于 Eclipse 3.x 开发的，在高版本 Eclipse 4.x 上可能加载失败。不过 FreeMarker IDE 这类结构简单的插件，实测下来在高版本 Eclipse 上也有机会跑起来，关键是看启动日志报不报错。
2. JVM 位数。Eclipse 自身分 32 位和 64 位，JAD 的 jad.exe 也有对应的可执行版本。如果 Eclipse 是 64 位的，却配了一个 32 位的 jad.exe，反编译时可能正常，但某些环境下会出现莫名问题。
3. JDK 版本。老 Eclipse 用新 JDK 启动有时会报UnsupportedClassVersionError，反过来也一样。解决思路就是给 Eclipse 指定一个兼容的 JRE。

3. FreeMarker IDE 插件离线安装全程实录

3.1 在有网络环境的机器上准备插件文件

既然目标是“离线安装”，那准备工作一定是在一个有网络的机器上完成，或者从同事的共享资料里拷贝。建议找一台能联网的开发机，打开 Eclipse 插件市场（Eclipse Marketplace），搜索FreeMarker IDE或freemarker-ide，然后把安装源 save 成本地 zip。如果没有插件市场入口，也可以从插件发布页面下载更新站点归档，这种文件的文件名里通常带site或update site字样。

拿到 zip 之后，解压到一个临时目录，检查根目录：

freemarker-ide-site/ |-- content.jar |-- artifacts.jar |-- features | `-- org.freemarker_2.0.4.jar `-- plugins `-- org.freemarker_2.0.4.jar

如果看到的是这种结构，它就是“更新站点”形式，在联网环境里可直接作为本地源使用。但我们的最终目标是把插件放到目标机器的dropins，所以需要把features和plugins这两个子目录完整抽出来，放到指定位置。

有另外一个常见结构是直接包含features和plugins的插件包，那就更简单了，整个目录就是一个可以挂载的插件包。

3.2 在目标 Eclipse 上正确放置插件

找到目标机器上的 Eclipse 安装根目录。以常见目录为例：

D:\eclipse\ |-- eclipse.exe |-- configuration |-- dropins |-- features |-- plugins

新版本 Eclipse 通常自带dropins文件夹，如果没有就手动创建一个。推荐在dropins下面建立专用子目录：

D:\eclipse\dropins\ `-- freemarker\ `-- eclipse\ |-- features\ | `-- org.freemarker_2.0.4.jar `-- plugins\ `-- org.freemarker_2.0.4.jar

这里有一个非常容易踩的坑：dropins下直接放features和plugins目录，部分 Eclipse 版本不认。正确的挂载路径必须是“一级子目录/eclipse/features”这种结构。也就是说，在dropins目录下的每个子文件夹代表一个插件，插件内部要模拟一个迷你 Eclipse 根目录，里面再放features和plugins。

如果你拿到的是更新站点 zip，里面已经有features和plugins，可以考虑把这两个目录分别合并到 Eclipse 的features和plugins目录。这是最“粗暴”的方式，很多老教程都这么写。但说实话，这种方式有个问题：插件文件夹一旦混入主目录，出问题时很难判断是哪个包造成的，将来清理也费劲。所以我还是建议优先dropins，前提是要把层级结构弄对。

3.3 启动参数与验证

插件放好后，重启 Eclipse 时最好先执行一次-clean。这个参数会清掉 Eclipse 的缓存，强制它重新扫描插件目录。对于刚拷贝进去的插件，不带-clean启动偶尔能识别，但遇到缓存坏掉的情况就是识别不了。保险起见，命令行启动：

eclipse.exe -clean

启动之后验证分三步：

1. 打开Window > Preferences，搜索FreeMarker，看是否存在对应的偏好设置页。如果能看到，说明插件已经被 OSGi 运行时加载。
2. 新建一个a.ftl文件，输入一行<#if x>hello</#if>。如果#if和hello有不同颜色，说明编辑器已经接管了这个文件类型。
3. 在 Preferences 的General > Editors > File Associations里，确认*.ftl已经关联到 FreeMarker Editor。如果没有自动关联，手动添加一下，再设置默认为编辑器。

这些操作都完成后，FreeMarker IDE 插件基本就落地了。后续如果在模板里还想要变量自动补全，通常还需要配置模板使用的数据模型，但这是插件用法层面的问题，后面分享经验时再说。

3.4 这个插件安装时我最担心的两个问题

第一个问题是“装了但 Preferences 里搜不到 FreeMarker”。这时候不要反复重启，先去 Eclipse 安装目录下面的.metadata/.log文件里看启动日志。如果你找不到这个文件，可以通过Window > Show View > Error Log查看，错误信息里通常会提示某个 plugin 不能解析。常见原因是插件 jar 和当前 Eclipse 的 OSGi 版本不兼容，可以先找到features目录下对应 feature manifest 里的依赖声明，判断是不是对org.eclipse.ui或者org.eclipse.core.runtime的版本要求太老。

第二个问题是老插件和新 IDE 的兼容性警告。有时候 Eclipse 会正常加载，但启动时弹出一条“插件包含未解决的依赖”之类的错误。这种情况不一定致命，关键看 Error Log 里有没有未加载的 bundle。只要编辑器能关联上.ftl文件，功能就算可用。对于老项目的日常维护，这已经足够了。

4. JAD 反编译插件离线安装与配置

4.1 提前把 jad.exe 和 JadClipse 插件准备到位

JAD 反编译插件的完整链条有两个重要组件：一个是 IDE 插件本身，也就是 JadClipse；另一个是命令行反编译工具jad.exe。插件只是界面壳子，真正把字节码变成 Java 代码的是后者。所以离线准备时，一定不能只下载插件而忘了下载反编译工具本体。

如果你所在的内网完全无法访问公网，可以在配置好的外网机器上下载好：

• jad.exe（Windows）jad可执行文件（Linux/macOS），注意选择操作系统对应的版本。
• JadClipse 插件 zip，一般文件名叫jadclipse_x.x.x.jar或直接就是包含features/plugins结构的 zip。

强烈建议把这两个文件一起放在内网共享目录，命名带上版本号。我在实际操作时吃过亏：同事只发了一个插件 jar，我以为装完就能反编译，结果在配置界面里要填 jad 路径时才发现没工具本体，又折腾了一圈。

4.2 插件放置与运行配置

假定你把 JadClipse 插件解压后是一个features+plugins结构的目录，那么同样按照dropins规则放到 Eclipse 根目录下：

D:\eclipse\dropins\ `-- jadclipse\ `-- eclipse\ |-- features\ | `-- jadclipse_3.3.0.jar `-- plugins\ `-- jadclipse_3.3.0.jar

有些 JadClipse 插件包直接就是一个 jar 文件，也有教程把 jar 直接放到dropins下的某个子文件夹里。这时候你需要认清，如果这个 jar 本身是一个 bundle，不是 feature，那么它的位置可以放在dropins/jadclipse/plugins/xxx.jar，但最好再补一个对应的 feature。如果只有一个 plugins jar，依靠自动识别也可能加载成功，但稳定性不如完整结构。

放好之后，还是启动eclipse.exe -clean。然后在菜单栏打开：

Window > Preferences > Java > JadClipse

这个页面需要配置一项目录：Path to decompiler指向你的jad.exe或jad可执行文件的完整路径。Windows 上建议路径不要包含空格，如果必须包含，要老老实实写全路径或用环境变量帮它规避。配置完毕后，下方通常还有反编译参数设置，比如是否显示行号、是否处理注释等。对于老项目，默认参数足够。

4.3 让 class 文件默认用 JadClipse 打开

插件加载后，需要在 Eclipse 的Package Explorer或Project Explorer里找一个.class文件，右键点击，选择Open With > JadClipse。如果你没有在Open With列表里看到 JadClipse，可以先在别的 class 文件上试一次，如果还是不行，就回到Preferences > General > Editors > File Associations，找到*.class，添加 JadClipse 作为关联编辑器。

一旦手动关联成功，后续再双击任意.class文件，Eclipse 就会调用 JadClipse，把字节码反编译成 Java 代码显示在编辑区。第一次打开时如果你的 jad.exe 路径配置错误，编辑器会显示一段反编译失败的信息，同时 Error Log 里会记录错误，这也是排查的重要线索。

4.4 实际操作上的几个反编译经验

JAD 的问题是功能太老，它对 Java 5 之后的不少新语法支持有限。如果你反编译的 class 是用新版本 JDK 编译的，尤其是包含泛型、枚举、注解等高版本特性，JAD 很容易报格式解析错。处理这些 class 时，我更倾向于使用 JD-Core 或 CFR 这类现代反编译工具。但在老项目里，大部分 class 都是老 JDK 编译出来的，JAD 的优势就体现出来了：启动快、依赖少、不占内存，双击即可看结果。

另一个经验是要注意编码问题。反编译出来的源码里如果出现中文乱码，先查一下jad.exe默认输出使用的字符集，再在 JadClipse 偏好设置里调整输入输出编码。常见场景是 Windows 上 GBK 乱码，Linux 上 UTF-8 乱码，改编码后再打开一次通常就能恢复。如果你需要把反编译结果保存成文件用于后续分析，建议直接在编辑器里全选复制出来，另存为对应编码的新文件，避免 JadClipse 自带的导出功能覆盖原文件导致混乱。

5. 常见问题与排查技巧实录

5.1 插件放了但就像没放一样，问题出在哪

“我明明把插件放到dropins了，怎么重启之后还是老样子？”这个问题我见得太多了。优先级最高的一步是确认目录结构。你要在 Eclipse 根目录下打开dropins，确认是dropins\freemarker\eclipse\features和dropins\freemarker\eclipse\plugins，而不是dropins\features。后者是相当普遍的放法，但 Eclipse 不一定认。

如果目录结构没问题，再执行一次eclipse -clean，重点观察启动过程中有没有报错。很多时候 Eclipse 不是没扫到插件，而是插件在加载时抛了异常被忽略掉。这时候workspace/.metadata/.log文件是唯一可信的真相来源，任何 UI 层面的猜测都不如直接看日志来得快。

5.2 Eclipse 启动卡在进度条，怎么定位是哪个插件

离线安装多个插件后，Eclipse 可能在启动时卡在加载界面，长时间弹不出主窗口。这种情况通常是某个插件的初始化代码在启动阶段抛了异常，甚至触发了死锁。我的排查做法是：先把dropins下新建的两个子目录全部移走，如果能正常启动，再逐一加回来，每加一个做一次-clean重启。这种“排半法”排查插件问题，虽然笨，但非常有效。

定位到是哪个插件后，再看日志里的异常栈。如果异常发生在 FreeMarker 插件初始化时，可能是它依赖了某个旧版本的标准库，和当前 JVM 不匹配；如果异常发生在 JadClipse，多和jad.exe路径、JNI 调用有关。根据异常信息去选择另一个版本或换一个配套工具，比硬改插件配置靠谱。

5.3 两个插件同时装的依赖冲突

FreeMarker IDE 和 JadClipse 本身功能域完全不一样，一个管模板文件，一个管 class 文件，理论上不会冲突。但相同版本的 Eclipse 在同时加载多个第三方插件时，如果它们依赖不同版本的公共包，OSGi 会尝试处理，处理不了就会出现“捆绑包解析失败”。所以我不建议一次性把两个插件全塞到dropins里还同时启动，尤其是第一次装的时候。先装一个，验证正常，再装另一个。即便两个插件最终能共存，这种逐步验证的方式也能把变量控制到最小。

我实际装的时候是先装 JadClipse，反编译验证通过，再装 FreeMarker IDE。这样如果后来启动异常，至少能确认是第二个插件引起的，不用从头排查。

5.4 问题排查速查表

这张表基本覆盖了我遇到过的九成问题。如果不在表里，多半是版本级兼容性坑，建议把对应插件换成更适合当前 Eclipse 版本的旧版或新版。

6. 一些额外心得与扩展建议

6.1 把“插件全家桶”复制到一个干净目录

离线安装插件这件事，不只是个人开发机上的临时需求。团队里有几个人都在用同一个隔离网段，总不能一个人一个人地装插件。我后来用了一个更省事的办法：在一台已经把所有插件装好的 Windows 机器上，把整个 Eclipse 安装目录打成一个压缩包，复制到内网共享盘。新人在拿到这个包后，不用再安装任何插件，直接解压运行eclipse.exe即可。

不过有一个地方要额外处理：Eclipse 安装目录里如果带了上次的工作区路径信息，直接换成新机器后，启动时可能因为找不到原工作区而弹出提示。这时候可以删除eclipse目录下的workspace缓存目录（如果存在），或者在启动命令后面新增一个-data 路径参数，让 Eclipse 直接使用本地工作区。这样既能保留插件，又能避免路径问题。

6.2 老工具和老项目配合，效率反而更高

很多人觉得“老 Eclipse + 老插件 + JAD”这套组合已经过时。但在一个隔离的内网环境里，没有现代 IDE 的在线更新、没有足够的硬件资源，老组合反而是最稳定的。FreeMarker IDE 提供的高亮和补全，已经能覆盖老项目大部分模板开发需求；JAD 反编译虽然是上个时代的产物，但老项目编译产物用起来轻快直接。别盲目追求新工具，关键是找到适合当前项目的组合。

我自己后来保留了一套离线安装包清单：FreeMarker IDE 插件、JadClipse 插件、对应平台的 jad 工具、以及一个干净版 Eclipse 压缩包，全部放在内网共享目录。以后再遇到类似项目，半小时内就能把开发环境搭好。这个习惯让老项目维护轻松了不少，也顺便避免了一堆插件安装问题。如果你也在维护老系统，建议从这套思路开始，先解决有无问题，再慢慢优化使用体验。