企业官网建设流程全解析

简介：面向初次接触 UML 建模的软件开发者、系统分析师与项目经理，这份 docx 文档围绕 IBM Rational Rose 的环境搭建与上手准备展开，帮助读者梳理版本选择、许可协议、安装类型、安装路径及首次启动配置等关键环节，并补充许可证与兼容性问题的排查思路。资源包共 1 个文件，是约 16KB 的 docx 文档，内容精炼，适合作为课程配套资料或自学参考，便于快速定位安装过程中的注意点。当前已有 1263 人学习，在建模工具入门场景中具备一定参考价值。内容还涉及工作空间设置、项目模板导入，以及 Rational Rose 与相关 IBM Rational 工具配合使用的说明；读者可根据这些内容完成环境准备，并继续开展类图、用例图等 UML 建模实践，减少因配置不当造成的返工。

1. Rational Rose 安装教程要解决的真正问题：老建模工具在新机器上跑通

接手一个用 UML 做课程设计的建模任务时，多数人第一反应是搜一份 Rational Rose 安装教程，把安装包一路双击到底。真到机房里跑起来才发现，rationalrose 这套建模工具的难点根本不在点“下一步”，而在版本、许可、系统位数和那堆老依赖能不能对上。这份课程资源把安装流程、目录结构、许可配置和首次建模入口串成了一条线，适合要交 UML 课设的人、需要维护历史 .mdl 模型文件的工程师，以及给老项目补设计文档的系统分析师。下面按我自己复现的顺序拆，能抄的地方直接抄，会翻车的地方提前标出来。

2. 装前环境盘点：位数、依赖组件与安装包校验的三件事

2.1 先确认目标版本与操作系统位数

Rational Rose 是典型的 32 位时代产物，装在 64 位 Windows 上能跑，但它的注册表写入会被重定向到WOW6432Node，插件和许可信息的实际位置跟安装向导里看到的不一样。这一步没搞清楚，后面配许可、注册 XMI 导出插件时会一直找错键。先确认当前系统架构，再决定安装目录和注册表路径。

@echo off echo 处理器架构: %PROCESSOR_ARCHITECTURE% echo 系统盘: %SystemDrive% ver

%PROCESSOR_ARCHITECTURE%返回AMD64说明是 64 位系统，返回x86说明是 32 位。64 位系统下，32 位程序的注册表项落在HKLM\SOFTWARE\WOW6432Node\...，而安装向导和多数老教程写的是HKLM\SOFTWARE\...，这是最常见的“照着教程改注册表却没生效”的原因。判断清楚之后，安装目录建议统一放到非系统盘，比如D:\Rational\Rose，好处有三个：避开Program Files的 UAC 虚拟化，导出脚本拼路径时不会被空格截断，重装系统时模型和配置还在。

安装包本身也要先看清楚是什么形态。常见的有三种：自解压 exe、ISO 镜像、以及从归档页下下来的 zip。自解压 exe 双击时会先解压到%TEMP%再启动安装器，如果临时目录路径里有中文或空格，解压阶段就可能静默失败。稳妥做法是先用解压工具把内容释放到一个短路径，比如D:\pkg\rose，再从释放出来的setup.exe启动。ISO 则用系统自带的挂载功能挂成盘符，不要直接在里面双击运行，挂载盘是只读的，安装器写临时文件会失败。

还要确认安装包内是否带redist或third_party这类目录。老建模工具的安装器往往不会自动补齐运行库，它默认你机器上已经有了。安装前把这些目录扫一遍，比装完再到处找缺哪个 dll 省事得多。

2.2 依赖组件：缺一个就是启动闪退

Rational Rose 启动失败里相当大的比例不是安装坏了，而是依赖没到位。下面这张表是我在几台干净虚拟机上复现后整理的，具体文件名以安装包内实际内容为准，不要照抄文件名，照抄的是判断方法。

这里有个反直觉的点：64 位系统上装 VC++ 运行库，很多人下意识装 x64 版，但 Rational Rose 主程序是 32 位的，它加载的是 32 位运行库。两个都装不冲突，但如果只装 x64，启动照样报缺 dll。判断方法很直接，看安装目录下主程序的位数，或者用任务管理器看进程是否带“32 位”标记。

JRE 这块要特别注意版本。老工具对高版本 JRE 往往不认，装完系统里最新的 JDK 反而会让插件面板加载失败。常见做法是让安装包自带的 JRE 独立存在，不要把它加进系统JAVA_HOME，避免和其他开发环境打架。如果机器上已经有别的 Java 环境，装完之后临时把JAVA_HOME指向安装目录下的 jre 再启动一次，能快速判断是不是版本冲突。

2.3 安装包完整性校验：先留哈希再动手

从归档渠道拿到的老安装包，最怕的是下载不完整或者被二次打包过。安装到一半报“cab 文件损坏”，重下重装能耗掉半天。花两分钟做一次哈希清单，后面出问题能立刻定位是包的问题还是环境的问题。

# 在安装包所在目录执行，生成 SHA256 清单 Get-ChildItem -Path .\rose_pkg -Recurse -File | ForEach-Object { $hash = (Get-FileHash $_.FullName -Algorithm SHA256).Hash "{0} {1}" -f $hash, $_.FullName.Substring((Get-Location).Path.Length + 1) } | Out-File .\manifest_sha256.txt -Encoding utf8

Get-FileHash的-Algorithm SHA256是算法参数，老包也可以用 MD5，但 SHA256 更稳妥。Substring那一段是把绝对路径裁成相对路径，方便跨机器比对。生成的清单建议跟安装包放一起，装完之后如果怀疑某个文件被替换，重新跑一遍对比即可。

校验完之后还有一个动作容易被忽略：把安装包目录设为只读或者复制一份留存。老安装器在工作过程中会往自己所在目录写日志和临时配置，装完之后目录里多出一堆文件，下次想复用这个包就分不清哪些是原始的。我一般会把原始包单独放一个pkg_origin目录，装的时候用副本。

3. 安装流程拆到每一步：静默参数、许可落盘与首次启动配置

3.1 图形安装与静默安装的参数差别

图形安装没什么可讲的，一路下一步，唯一要盯的是安装类型那一步。选“标准安装”会带上示例模型和附加组件，第一次装建议就选它，因为示例模型是后面验证 XMI 导出是否正常的最好素材。选“自定义”则适合只想装主程序、磁盘紧张的场景，但要注意自定义里如果把 XMI 导出插件取消勾选，后面导出功能是找不到的，得单独补装。

真正需要抄作业的是静默安装，批量部署或者反复重装时用得上。Rational Rose 这类安装器多数基于 InstallShield 或 MSI 封装，参数写法不一样，先看安装包根目录有没有.msi文件。

@echo off setlocal set PKG=%~dp0 set TARGET=D:\Rational\Rose set LOG=%PKG%install_rose.log if not exist "%TARGET%" mkdir "%TARGET%" rem /s 静默，/v 把后面的参数透传给内层 MSI rem /qn 无界面，INSTALLDIR 覆盖默认目录，/l*v 输出详细日志 start /wait "" "%PKG%setup.exe" /s /v"/qn INSTALLDIR=\"%TARGET%\" /l*v \"%LOG%\"" echo 安装器退出码: %ERRORLEVEL% endlocal

这段脚本的关键在参数分层。/s是外层 InstallShield 的静默开关，/v"..."里的内容原样交给内层 MSI，所以/qn、INSTALLDIR、/l*v都是 MSI 的参数。INSTALLDIR用了转义引号，因为路径里可能有空格。/l*v会写出非常详细的日志，装失败时直接搜日志里的Return value 3就能定位到具体动作。

如果安装包是纯 MSI，写法换一下：

msiexec /i "D:\pkg\rose\RationalRose.msi" /qn /norestart ^ INSTALLDIR="D:\Rational\Rose" /l*v "D:\pkg\rose\msi_install.log"

/norestart阻止安装器自动重启机器，^是 bat 里的换行续行符。MSI 的退出码含义固定：0 成功，3010 成功但需重启，1603 是权限或已安装冲突，1605 是产品未安装。记住这几个码，排查时不用翻文档。

还有一种情况是安装器只提供 response file，也就是.iss应答文件。这类安装器的静默写法是/s /f1"setup.iss" /f2"setup.log"，/f1指定应答文件，/f2指定日志。应答文件里的路径是写死的，换机器之前要先改里面的szDir字段。

3.2 许可配置：文件放哪、变量怎么设

装完之后第一次启动会要求许可，这一步是新手最容易卡住的地方。许可形式一般分两种：节点锁定和浮动。节点锁定绑机器，适合个人机；浮动指向一台许可服务，适合机房。课程资源里给的通常是节点锁定形式，一个许可文件加一段授权信息。

许可文件不要放在安装目录下，因为卸载重装会连同目录一起清掉。我习惯单独建一个D:\Rational\lic目录，把许可文件放进去，然后设系统环境变量指向它。这样重装主程序时许可不用重新配。

@echo off rem 以管理员身份运行；变量名以安装包文档为准，这里用 ROSE_LICENSE_FILE 代指 setx ROSE_LICENSE_FILE "D:\Rational\lic\rose.lic" /M setx ROSE_HOME "D:\Rational\Rose" /M rem 验证是否写入成功 reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v ROSE_LICENSE_FILE

setx的/M表示写系统级变量，需要管理员权限；不加/M只对当前用户生效，换用户登录就失效。setx写入后当前命令行窗口不会立即生效，要新开窗口或者重新登录。最后的reg query是验证动作，能看到值说明写进去了。

许可还有两个隐性坑。一是系统时间。节点锁定许可通常带有效期，机器时间如果被改到有效期之外，启动会直接报许可无效，表现得很像“许可文件坏了”。二是旧版本残留。如果机器上装过同系列的其他版本，注册表里可能留着旧的许可键，新版本启动时优先读了旧键。这种情况用安装器自带的修复功能不一定管用，得先把旧键导出备份再清掉。

提示：改注册表之前先导出备份，命令是reg export "HKLM\SOFTWARE\WOW6432Node\Rational" d:\backup\rational_bak.reg /y，出问题能一键回滚。

3.3 首次启动配置：把默认行为调成顺手的样子

第一次启动成功不代表配好了。默认配置里有几项会让后面很难受，趁首次启动一次改掉。

第一项是启动时自动打开上次的模型。这个选项在单人单机时很方便，但在共享机器或者做课设演示时，容易一打开就是别人留下的半成品模型，还可能是只读的。关掉它。

第二项是自动保存间隔。老工具默认的自动保存可能很久才触发一次，画了半天的图遇上异常退出就全没了。调到 5 到 10 分钟，并且把自动保存目录指到一个固定位置，方便找回。

第三项是默认模型目录。默认往“我的文档”里塞，路径里带中文和空格，后面用脚本批量处理 .mdl 时会很难受。改成D:\Rational\models，全英文无空格。

第四项是撤销层级。这个在部分版本里是默认关闭的，画图时误删一个类找不回来，血泪经验就是先把它开到能用为止，具体层级看版本支持，别贪多，开太高会明显拖慢大模型的操作响应。

配置改完，建议立刻新建一个空模型保存一次，确认目录可写、编码正常。这个空模型后面可以当模板用。

4. 让 .mdl 模型真正打开：文件结构、最小建模与 XMI 导出

4.1 .mdl 文件是什么，为什么不能直接文本编辑

Rational Rose 的模型文件后缀是.mdl，它不是一个可以直接用记事本改的纯文本文件，多数版本里它是私有容器格式，内部按单元存放包、图、元素和关系。这意味着两件事：第一，不要用文本编辑器打开再保存，哪怕看起来像文本，保存一次就可能把结构写坏；第二，版本之间不完全兼容，高版本存的模型在低版本里打开，可能只读或者直接报错。

处理历史模型的标准动作是：先复制一份副本，再打开副本。档案里拿出来的 .mdl 经常带只读属性，直接打开后编辑不了，很多人的第一反应是“软件坏了”，其实看属性就知道。

# 批量去掉模型目录下的只读属性，并统计文件大小 Get-ChildItem -Path D:\Rational\models -Filter *.mdl -Recurse | ForEach-Object { if ($_.IsReadOnly) { $_.IsReadOnly = $false } "{0}`t{1:N0} KB" -f $_.FullName, ($_.Length / 1KB) }

IsReadOnly是文件对象属性，直接赋值$false即可取消只读。这段还顺便输出了文件大小，.mdl文件异常小，比如只有几 KB，往往说明它是个空壳或者保存时中断了，打开前就该有心理准备。真正带完整类图和用例图的模型，体积通常不会这么小。

4.2 最小建模流程：三类图跑通就算环境验收

装完环境之后不要急着导入真实项目，先建一个最小模型，把“新建—编辑—保存—再打开”这条链路走通。具体步骤：

1. 新建模型，选择默认模板，不用附加组件。
2. 建一张用例图，放两个参与者、三个用例，连一条包含关系。
3. 建一张类图，放三个类，每个类加两三个属性和一个方法，类之间连一条关联和一条继承。
4. 建一张序列图，两个对象之间发三条消息。
5. 保存到D:\Rational\models\smoke_test.mdl，关闭程序，重新打开这个文件。

这五步看着简单，但它把最容易出问题的环节都覆盖了：模板加载、图元渲染、关系连线、保存编码、再打开兼容性。如果第三步里中文类名显示成方框，问题在字体；如果第五步重新打开提示格式错误，问题在保存路径或权限；如果序列图里消息箭头画不出来，问题在插件或界面主题，不在模型本身。

建完之后再补一个动作：另存为一份副本，用不同文件名。这一步是为了验证目录权限和文件名规则。有些环境对长文件名或者特殊字符支持不好，改个短名字就正常了，这种玄学问题提前踩掉比上线时踩好。

4.3 导出 XMI：让模型能被别的工具读

.mdl是私有格式，团队里如果有人用别的建模工具，或者要把模型喂给文档生成脚本，就得靠 XMI 导出。XMI 是标准交换格式，不同工具都能读，但导出质量取决于插件版本和模型本身的规范程度。

导出路径一般在菜单的导出或工具项里，具体措辞各版本不同，找带 XMI 字样的项就行。导出时有两个参数要选：XMI 版本和导出范围。版本选低了会丢构造型信息，选高了老工具可能读不了，常见做法是先导 1.x 版本试，读得通再考虑更高的。范围建议按包导出，不要一次全导，大模型一次导出容易在中途失败，而且失败后不好定位是哪个包的问题。

导出完不要只看文件存不存在，要校验内容。

import sys import xml.etree.ElementTree as ET from pathlib import Path def check_xmi(path: Path) -> int: """检查导出的 XMI 是否良构，并粗略统计关键元素数量。 返回值：0 正常，1 内容异常，2 文件缺失 """ if not path.exists(): print(f"[缺失] {path}") return 2 try: tree = ET.parse(path) except ET.ParseError as exc: print(f"[不良构] {path.name} -> {exc}") return 1 root = tree.getroot() # XMI 的命名空间前缀各工具不同，这里用标签后缀匹配，避免写死前缀 key_tags = ("Class", "UseCase", "Actor", "Association", "Package") counts = {tag: 0 for tag in key_tags} for elem in root.iter(): for tag in key_tags: if elem.tag.endswith(tag): counts[tag] += 1 total = sum(counts.values()) print(f"[OK] {path.name} 根节点={root.tag} 元素统计={counts} 合计={total}") return 0 if total > 0 else 1 if __name__ == "__main__": targets = [Path(p) for p in sys.argv[1:]] or list(Path(".").glob("*.xmi")) codes = [check_xmi(p) for p in targets] sys.exit(max(codes) if codes else 2)

逻辑说明：ET.parse负责良构校验，解析失败的 XMI 在别的工具里基本也打不开，先在这一步拦住。标签匹配用endswith而不是写死命名空间前缀，因为不同工具导出的前缀不一样，写死会导致统计永远是 0。返回码设计成 0、1、2 三档，是为了能直接放进批处理里，退出码非 0 就中断后续步骤。

参数说明：脚本接受任意多个文件路径作为参数，不传参时默认扫当前目录的*.xmi。key_tags里那五个是判断“模型有没有实质内容”的最小集合，实际项目里可以按需加State、Component之类的标签。统计数为 0 说明导出的是空壳，多半是导出范围没选对，或者包本身就没内容。

如果导出报错，先看插件有没有注册。插件的注册信息通常在安装目录的addins或类似目录里，配合注册表项工作。64 位系统上要注意注册表重定向问题，前面提过的那条路径规则在这里同样适用。

5. 翻车现场排查：五类启动失败与导出异常的现象、原因和解法

5.1 双击安装包没反应，进程一闪就没了

现象：双击setup.exe，鼠标转一圈就没动静了，任务管理器里也找不到安装进程。

原因：安装器先把内容解压到临时目录再启动，临时路径含中文、空格，或者当前用户对%TEMP%没有写权限，解压阶段就失败了；另一种情况是安装包被杀软或策略拦了，进程被静默终止。

解决：把安装包整体解压到短路径，比如D:\pkg\rose，然后以管理员身份运行释放出来的setup.exe。临时目录也建议改成D:\tmp，改完重新登录生效。如果是策略拦截，先在隔离区确认文件来源，再决定是否放行，不要盲目关防护。

5.2 装完启动提示许可无效，但许可文件明明存在

现象：启动弹许可错误，指向的文件路径确实有文件，大小也正常。

原因：三个方向。环境变量写成了用户级，当前是用另一个账号登录的；系统时间被改到了许可有效期之外；机器上装过旧版本，注册表里残留旧许可键，新版本优先读了旧的。

解决：先用set命令在当前窗口看变量到底有没有值，没有就说明写错了作用域。时间问题把系统时间调回正确值再启动。残留键的问题先导出备份，再清理旧版本对应的键，注意 64 位系统下要同时看SOFTWARE和SOFTWARE\WOW6432Node两处。

5.3 界面文字变方框，或者菜单一片空白

现象：主界面能打开，但菜单文字是方框，图里的中文标注也是乱码，插件面板点开是空的。

原因：系统缺基础中文字体，或者显示缩放比例不是 100%，老程序的界面布局在高 DPI 下会错位；插件面板空白通常是 JRE 版本不匹配，加载器初始化失败但没弹错误。

解决：先补装字体，再把显示缩放调回 100% 重启程序验证。如果只是插件面板空，把JAVA_HOME临时指向安装目录自带的 JRE 再启动，能加载就说明是版本冲突，后续固定用自带版本。这个坑很玄学，同一台机器换个登录用户表现都可能不一样。

5.4 打开旧模型只读，或者提示版本不兼容

现象：从档案里拿到的.mdl打开后不能编辑，工具栏是灰的，或者直接弹版本错误。

原因：文件本身带只读属性，从压缩包里直接双击打开时最常见；另一种是高版本保存的模型在低版本里打开，格式不向前兼容。

解决：先把文件复制到本地目录，去掉只读属性再打开，不要在网络盘或压缩包预览里直接编辑。版本问题只能升不能降，用高版本打开后另存为新文件，或者让对方导出 XMI 再导入，虽然会丢一些工具私有信息，但至少能读。

5.5 XMI 导出成功但文件是空的

现象：导出过程没报错，文件也生成了，大小只有几百字节，导入别的工具后什么都没有。

原因：导出范围没选中任何包，或者模型里的元素不在标准 UML 命名空间下，插件直接跳过了；还有一种情况是导出插件版本太老，遇到构造型就中断，产出一个不完整的文件。

解决：先确认导出时选中了具体的包而不是根节点，再检查模型里有没有大量自定义构造型，有的话分批次导出，把带构造型的部分单独处理。导出后用上一节那个脚本跑一遍，元素统计为 0 就别往下走了，先解决导出范围的问题。

6. 进阶用法：用巡检脚本把安装和模型检查变成可复现动作

装一次能跑不算本事，换台机器还能一次跑通才算。我后来的习惯是把安装后的关键检查点写成一个脚本，每次新环境部署完跑一遍，把“感觉没问题”变成“有输出为证”。

import shutil import sys from pathlib import Path def audit(install_dir: str, min_free_gb: float = 2.0) -> list[str]: """安装环境巡检，返回问题列表，空列表表示通过。""" issues: list[str] = [] p = Path(install_dir) if not p.exists(): issues.append(f"安装目录不存在: {p}") return issues # 老工具对路径最敏感的两点：空格和非 ASCII 字符 if any(ch.isspace() for ch in install_dir): issues.append("安装路径含空格，外部脚本调用时容易被截断") if any(ord(ch) > 127 for ch in install_dir): issues.append("安装路径含非 ASCII 字符，导出和日志写入可能异常") # 磁盘余量：模型文件和自动保存副本会持续增长 free_gb = shutil.disk_usage(p).free / (1024 ** 3) if free_gb < min_free_gb: issues.append(f"剩余空间不足: {free_gb:.1f} GB < {min_free_gb} GB") # 关键子目录与日志检查 log_dir = p / "logs" if log_dir.exists(): for log in log_dir.glob("*.log"): text = log.read_text(encoding="utf-8", errors="ignore") for line in text.splitlines(): low = line.lower() if "error" in low or "fail" in low: issues.append(f"{log.name}: {line.strip()[:120]}") break return issues if __name__ == "__main__": target = sys.argv[1] if len(sys.argv) > 1 else r"D:\Rational\Rose" found = audit(target) if not found: print("[PASS] 环境巡检通过") sys.exit(0) for item in found: print(f"[WARN] {item}") sys.exit(1)

这个脚本的min_free_gb是我按“一个中等规模课设模型加若干自动保存副本”估的，实际项目模型大的话往上调。日志检查只取每个文件的第一条错误，是为了避免刷屏，真要看细节还是打开原日志搜。退出码 0 和 1 的设计让它能直接串进部署脚本，巡检不过就停下来，不要带着问题往下装。

配套还有一个动作值得固化：模型目录的版本快照。.mdl不能文本 diff，但可以按时间戳做增量备份，每次大改之前复制一份带日期的副本。这事儿听着土，真到模型打不开的那天，它就是后悔药。

最后说个我自己的教训。早些年装这类老工具，我总凭记忆点下一步，装完能启动就算完事，结果换台机器重来一遍，许可、字体、注册表重定向全得重新踩。从那以后我每次部署完都强制走一遍巡检脚本，把输出存进项目目录，下次出问题第一件事就是翻上一次的通过记录做对比。工具老是客观事实，把流程固化成脚本是唯一能自己控制的部分。希望帮到你。

本文还有配套的精品资源，点击获取