简介这份资源是一份面向软件开发者、系统分析师与项目经理的 Rational Rose 安装指导文档聚焦 IBM Rational Rose 这款支持 UML 的建模工具在 Windows 环境下的部署与首次配置适合刚接触 UML 建模、需要在课程设计或项目实践中搭建建模环境的学习者参考。资源包内共 1 个 docx 文档体积约 16KB篇幅精简便于快速通读与随查随用。内容围绕获取安装文件、运行安装向导、接受许可协议、选择安装类型、设置安装路径、完成安装与许可证密钥配置、启动后的工作空间与项目模板设置等环节展开并补充了许可证异常、软件兼容性、功能操作不熟悉等常见问题的排查方向与官方文档、社区论坛、教程视频等求助渠道。目前已有 1260 人学习适合作为建模工具入门阶段的环境搭建速查材料。1. 装一个建模工具为什么有人能卡三天上周有人问我Rational Rose 安装到底难在哪——一个点完“下一步”就结束的向导为什么会卡住三天。真正的答案都在装完之后默认路径装进 Program Files在 Win11 上双击图标转两圈就消失许可变量没配启动直接弹框退出好不容易进了主界面打开课程资源里那批 .mdl 又提示版本不兼容。这些都不是向导会告诉你的。这篇把 Rational Rose 安装拆成三段装之前确认什么向导里哪三个界面不能一直点“下一步”装完用什么最小模型验证它确实能用。适合正在做软件建模课程设计、要交类图和用例图、或者接手了一批老 .mdl 模型文件的人。2. 装之前先看清工具链主程序、许可组件与版本适配2.1 把安装包拆开看五个目录决定后面会不会返工拿到手的安装介质通常是一个 ISO 或一个自解压 exe。很多人直接双击就完事我一般先把镜像挂载起来把根目录浏览一遍再动手。不是为了仪式感是因为这套工具链的插件和许可组件放在独立目录里装的时候勾不勾、装完再补装会不会冲突全看你有没有提前看清结构。典型的安装介质目录结构大致是下面这样目录/文件作用装之前要不要关注setup.exe主安装入口调用打包器解压并启动向导必须注意右键以管理员运行Disk1~DiskN分包数据老式多盘安装格式介质不完整时向导会中途报错addins正向工程/逆向工程插件Java、C、数据库要生成代码就必须勾选samples示例模型含类图、用例图、序列图样例强烈建议装用于验证license/flexlm许可管理组件与许可文件模板决定首次启动能不能进主界面重点看addins和license这两个目录。前者决定你装完之后能不能从模型生成代码骨架很多人装完发现“正向工程”菜单是灰的就是因为标准安装没带上插件后者决定首次启动时走单机许可还是内网许可服务选错了后面要卸载重来。samples目录别嫌占地方它是你验证安装是否完整的唯一免费素材比自建模型可靠得多。有个细节值得提前确认介质里的样例模型是低版本保存的。高版本打开低版本 .mdl 一般没问题反过来会直接拒绝。如果你手上的课程资源里混着不同年份的 .mdl先按文件修改时间排个序用最老的那个去试打开能开就说明向下兼容链路是通的。2.2 版本选型2003 还是 2007Win10/Win11 到底能不能跑这套工具的两个常见版本是 2003 和 2007都是 32 位程序界面用的还是上世纪的窗口风格。在 Win10/Win11 上跑不是不行但要接受几个前提安装包本身是老式打包器做的可能被 SmartScreen 拦一道主程序对高 DPI 不友好4K 屏上不加兼容性设置会糊成一片程序退出时偶尔不释放进程任务管理器里留着残影。选型上的实际判断标准不是“哪个新”而是“你的交付物用哪个打开”。课程设计一般指定 2007因为它的 XMI 导出更规范跟其他建模工具交换时字段丢得少如果导师给的模板是 2003 存的那就装 2003别硬上高版本再另存另存会丢掉一部分图形布局信息回来对不上图。两个版本不建议共存于同一台机器注册表里的许可键会互相覆盖症状是“明明配了许可另一个版本却报未授权”。兼容性设置这一步我一般装完立刻做不等出问题再补右键主程序 exe → 属性 → 兼容性 → 勾选“以兼容模式运行这个程序”选 Windows 7同一面板勾选“以管理员身份运行此程序”避免写配置时被 UAC 拦勾选“替代高 DPI 缩放行为”缩放执行选“系统”解决模糊和控件错位这三项不是玄学是 32 位老程序在新系统上的常规补丁。做完之后双击图标能稳定进主界面再往下做许可配置才有意义。2.3 装前三分钟的机器自检正式跑向导之前花三分钟做一次自检能省掉后面 80% 的返工。下面这段 PowerShell 检查系统版本、是否管理员、目标盘空间、路径合法性和关键运行库直接存成check-env.ps1跑就行。# check-env.ps1 —— Rational Rose 安装前环境自检 $ErrorActionPreference Stop # 1) 系统版本与架构确认是 64 位系统32 位程序可运行 $os Get-CimInstance Win32_OperatingSystem $arch $env:PROCESSOR_ARCHITECTURE Write-Host (OS: {0} Build {1} / Arch: {2} -f $os.Caption, $os.BuildNumber, $arch) # 2) 必须管理员身份运行否则写注册表和 Program Files 都会被拦 $isAdmin ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent() ).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator) Write-Host (IsAdmin: {0} -f $isAdmin) # 3) 目标盘剩余空间主程序 示例模型 后续模型文件预留 3 GB 比较稳 $freeGB (Get-PSDrive -Name D).Free / 1GB Write-Host (D: Free(GB): {0:N1} -f $freeGB) # 4) 路径合法性中文、空格、括号都会让老安装器解包失败 $target D:\Rational\Rose2007 if ($target -match [\u4e00-\u9fa5\s()]) { Write-Warning 目标路径含中文/空格/括号建议改成纯英文短路径 } # 5) 关键运行库盘点老程序依赖 VC 运行库缺了会在启动时静默退出 Get-ChildItem HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall, HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall -ErrorAction SilentlyContinue | ForEach-Object { (Get-ItemProperty $_.PSPath -ErrorAction SilentlyContinue).DisplayName } | Where-Object { $_ -like *Visual C*Redistributable* } | Sort-Object -Unique逐段说明一下。第 1 段只读系统信息不改任何东西第 2 段判断当前 shell 是不是管理员返回False就别往下装了先把 PowerShell 提权重开。第 3 段查 D 盘余量这里有个容易忽略的点这套工具生成的 .mdl 会随图形增多而膨胀一个几十张图的课程设计模型到后期能到几十 MB加上自动备份预留 3 GB 不算多。第 4 段的正则是最值得记住的一条。老式打包器在解包时对路径里的双字节字符和空格处理很差装到D:\我的课程\Rose下面症状往往是装到一半弹“无法写入文件”或者装完主程序起不来。纯英文、无空格、层级不超过三层是最省事的做法。第 5 段列出已装的 VC 运行库。这一步的意义在于缩小排查面如果启动时进程一闪而过、事件查看器里只有一条应用程序错误多半就是运行库缺失或者版本不对先补齐再谈其他。自检全部通过再插介质后面的步骤才有确定性。3. 走一遍安装向导六个界面里真正要动脑的三处3.1 向导界面逐项对照向导一共六七个界面大部分是“下一步”但有三处选错了要卸载重来。下面这张表是我按实际界面顺序整理的对照右边两列是可以直接抄的决策。界面你要做的决定我的建议理由欢迎页无直接下一步注意此时别勾选“快速安装”类选项许可协议接受/拒绝接受不接受无法继续没有绕过路径安装类型标准 / 最小 / 自定义自定义标准安装常常不带代码工程插件组件选择主程序 / 插件 / 示例 / 文档主程序插件示例文档可不装示例必须装安装路径默认或自定义自定义纯英文短路径见 3.2 节这条最容易翻车程序文件夹开始菜单名称保持默认改了不影响功能只影响自己找许可配置稍后配置 / 现在输入现在配置首启再配容易和试用期冲突“安装类型”这一项最值得停下来想两秒。最小安装只装核心建模器看着清爽但你后面想在类图上右键生成 Java 骨架时会发现菜单是灰的得重新跑一遍安装程序补装插件而补装过程会覆盖掉你已经改过的配置文件。自定义安装多花三十秒勾几个框比事后返工划算。“组件选择”里的示例模型也别跳过。它不只是学习素材更是安装完整性的探针装完能顺利打开自带样例并正常渲染所有图形说明主程序、图形库、字体资源这一整条链路是通的打不开样例基本可以断定是路径或权限问题早发现早处理。3.2 安装路径与权限为什么我把默认的 Program Files 改掉了默认路径是系统盘的Program Files目录。这个默认值在老程序上会引出一串麻烦主程序启动时要往自己的安装目录写 ini 配置和临时缓存而Program Files受 UAC 保护标准用户写入会被重定向到虚拟存储区表现就是“设置改了重启又变回去”更麻烦的是模型文件默认保存位置也在这棵树下团队共享时路径里带空格别人机器上解不开。我一般统一装到D:\Rational\Rose2007这种短路径装完立刻把目录权限显式授给当前用户避免后面写配置时被拦。这段可以在向导跑完之后执行# 建立安装根目录并授予当前用户完全控制避免首启写 ini 时被 UAC 拦 $root D:\Rational\Rose2007 New-Item -ItemType Directory -Path $root -Force | Out-Null $acl Get-Acl $root $rule New-Object System.Security.AccessControl.FileSystemAccessRule( $env:USERDOMAIN\$env:USERNAME, FullControl, ContainerInherit,ObjectInherit, None, Allow) $acl.SetAccessRule($rule) Set-Acl -Path $root -AclObject $acl # 复核确认规则已生效 (Get-Acl $root).Access | Where-Object { $_.IdentityReference -like *$env:USERNAME } | Select-Object IdentityReference, FileSystemRights代码里ContainerInherit,ObjectInherit这两个继承标志是关键它保证后续在目录下新建的子文件夹和模型文件自动继承权限不用一个个设。FullControl听起来给多了但在单机开发机上这是最省事的选择如果是多人共用的机器把它降成Modify就够避免误删别人的模型。跑完这段还可以顺手把 Windows 的“缩短文件名生成”关掉避免超长路径问题——模型文件里带长类名时系统生成的 8.3 短名会和实际文件名对不上导出时报找不到文件属于典型的老程序血泪经验。3.3 许可配置单机 key、许可文件与内网许可服务许可这一关是新手翻车最集中的地方。三种形态要分清单机 key一串字符首次启动时粘贴、许可文件一个 .lic 或 .dat指向本地路径、内网许可服务指向一台服务器的端口。选哪种取决于你拿到的授权形态不是随便挑的。环境变量是最通用的落地方式因为程序启动时会优先读它比在界面里手填稳。单机许可文件这样配# 方式一指向本地许可文件路径必须无空格 [Environment]::SetEnvironmentVariable( LM_LICENSE_FILE, D:\Rational\license\rose.lic, Machine) # 方式二指向内网许可服务的固定端口27000 是这类许可管理器的默认端口 # [Environment]::SetEnvironmentVariable(LM_LICENSE_FILE, 27000license-server, Machine) # 验证Machine 级别写入后当前会话不会自动刷新需要读回来确认 [Environment]::GetEnvironmentVariable(LM_LICENSE_FILE, Machine)参数上有几个点要盯住。第二个参数写Machine而不是User是因为这套工具在启动早期读的是系统级变量写在用户级下有时读不到尤其在以管理员身份运行的时候用户环境块会被替换。端口号 27000 是这类许可管理器的惯用默认值实际用哪个要问给你授权的人别自己猜。配完之后必须新开一个终端再验证当前 PowerShell 会话不会自动继承新写入的系统变量这是最常见的“明明配了却没生效”的假象。另外如果之前装过同系列的其他工具LM_LICENSE_FILE里可能已经有一个值了直接覆盖会把旧工具弄挂稳妥做法是用分号拼接# 保留已有值把新许可追加进去Windows 下多个许可路径用分号分隔 $old [Environment]::GetEnvironmentVariable(LM_LICENSE_FILE, Machine) $new if ([string]::IsNullOrWhiteSpace($old)) { D:\Rational\license\rose.lic } else { $old;D:\Rational\license\rose.lic } [Environment]::SetEnvironmentVariable(LM_LICENSE_FILE, $new, Machine) Write-Host 写入结果: $new3.4 首次启动工作空间、模板与显示设置第一次启动会引导你设工作空间workspace和默认模板。工作空间建议单独建目录别和安装目录混在一起模型文件、备份、导出的 XMI 都放里面后面迁移和打包提交都方便。启动后先把显示调顺。老程序在高分屏上默认字体发虚、图形框线断断续续通过兼容性设置里的 DPI 替代能改善一部分如果图形还是错位把系统缩放临时调到 100% 做一次建模确认不是程序本身的问题再调回去。这一步做完立刻做一次配置基线备份后面任何设置出问题都能一键回到可用状态# 首启调好设置后立刻备份一次配置基线 $stamp Get-Date -Format yyyyMMdd-HHmm $backup D:\Rational\backup\$stamp New-Item -ItemType Directory -Path $backup -Force | Out-Null # 用户目录下的 ini 配置文件 Copy-Item $env:USERPROFILE\*.ini $backup -ErrorAction SilentlyContinue # 注册表配置分支导出为 .reg可双击还原 reg export HKCU\Software\Rational Software $backup\rose-hkcu.reg /y Get-ChildItem $backup | Select-Object Name, Lengthreg export这条比很多人想的更有用。这套工具的工具栏布局、最近打开列表、插件启用状态都写在注册表里误点了“重置工具栏”或者插件加载失败用这个 .reg 双击导回去就恢复了比重装快得多。备份目录里我一般只留最近三次老的删掉避免越滚越大。4. 装完先别急着画大图用最小模型验证安装是否真的可用4.1 十五分钟建一个能跑通全链路的小模型装完不验证等于把问题攒到交图前一晚。我的做法是建一个最小模型包含两张图、三个类、一条关系够短但能触达建模器、图形库、代码工程插件三条链路。具体步骤新建模型选默认模板保存到工作空间下的smoke-test.mdl建一张用例图放两个参与者、三个用例画两条关联建一张类图放三个类其中一个类带两个属性、一个方法画一条关联和一条泛化保存、关闭、重新打开确认图形布局不跑位第 4 步是整段的关键。老程序在某些显卡驱动下保存时会丢掉图形的坐标偏移重开后所有元素挤在左上角。这个现象一旦出现说明图形渲染层和当前驱动不兼容后面画几十张图会反复遇到越早发现越好处理——临时方案是关掉硬件加速或换一个显示模式再试。另外这一步顺手确认一下字体。如果中文注释显示成方块是缺少对应字形不影响功能但影响交图。把类名和注释都写成中英混排一次就能试出来。4.2 正向工程从类图生成 Java 骨架验插件链类图画好之后右键目标类找代码生成入口选 Java指定输出目录。生成的骨架大致长这样// Rational Rose 正向工程生成的类骨架示意实际缩进和注释风格随模板配置 public class Order { private String orderId; // 对应模型里的 orderId: String private double amount; // 对应模型里的 amount: double public String getOrderId() { return orderId; } public void setOrderId(String orderId) { this.orderId orderId; } public double getAmount() { return amount; } public void setAmount(double amount) { this.amount amount; } }看生成的代码要确认三件事属性类型有没有按模型里的类型映射String 对 Stringdouble 对 double别全变成 Object方法名是不是按你设的命名规范来的驼峰还是下划线取决于模板配置文件是不是落在你指定的输出目录而不是安装目录。第三点尤其容易出问题输出目录留空时程序会往自己的安装目录写而那个目录如果没有写权限表现是“点了生成什么也没发生”连报错都没有。生成成功说明插件链是通的。如果菜单是灰的回到 3.1 节的组件选择补装代码工程插件如果点了没反应先查输出目录权限再查安装路径是否含空格。4.3 逆向工程与 XMI 导出验证模型文件不是孤岛正向跑通之后反向来一遍拿一个现成的 Java 源文件就上面生成的那个走逆向工程导入成类图看能不能正确识别字段和方法。这一步验证的是解析器很多人只用正向等到需要从别人代码里反推设计时才现学那时候出问题就来不及了。再往下是 XMI 导出。选 XMI 格式导出模型导出后用一个文本编辑器打开检查三样东西类的数量对不对、关联关系有没有保留、中文名称有没有变成乱码。XMI 是这套工具跟其他建模工具交换数据的唯一可靠通道导出正常说明你的模型不是孤岛后面交给别人或者存档都不会丢信息。到这里一个完整的验证闭环就走完了能建、能存、能重开、能生成代码、能反向解析、能导出交换格式。六项全过这套安装才算真的可用。5. 安装与首启的五个高频翻车点现象、原因与解法5.1 装的过程中翻车现象一向导跑到一半弹“无法写入文件”进度条卡在解包阶段。原因基本是路径问题。安装器在解包时用的是老式文件 API目标路径含中文、空格或括号时截断出错。另一种可能是介质本身不完整分包数据缺了一块。解法是先换成纯英文短路径重装比如D:\Rational\Rose2007换路径还报同样的错就去核对介质大小和分卷数量缺包只能重新取一份完整介质。装之前跑一遍 2.3 节的路径正则检查能把这类问题挡在前面。现象二装完在开始菜单找不到入口或者点了图标提示“找不到指定模块”。多半是安装过程被 UAC 中途拦了一次文件只写了一半主程序 exe 在但依赖的 DLL 没落地。解法是先确认安装目录下的可执行文件是否完整再以管理员身份重跑一遍安装程序选修复或覆盖安装。如果反复出现检查杀毒软件的实时防护日志老式安装器解包大量小文件的行为很容易被误判拦截。现象三装完能进主界面但“正向工程”相关菜单全是灰的。这是组件没装全标准安装默认不带代码工程插件。解法是重跑安装介质走自定义安装把插件目录勾上。注意补装时如果覆盖了已有的配置文件之前调的显示设置会复位所以补装前用 3.4 节的备份脚本存一份装完导回去。5.2 启动与许可证阶段翻车现象四双击图标鼠标转两圈进程消失没有任何提示。这是最典型的静默退出排查顺序是固定的先看事件查看器里的应用程序错误确认是缺运行库还是显卡相关问题再确认兼容性设置里的“以管理员身份运行”有没有勾上最后用 2.3 节的脚本扫一遍 VC 运行库。三步走完基本能定位。如果事件日志只显示一个模块地址用兼容模式降到 Windows 7 再试成功率不低。现象五启动弹许可错误提示找不到许可或已过期。原因有四种环境变量写在了用户级而不是系统级写了但当前会话没刷新看起来没生效许可文件路径里带了空格用了网络许可但本机到许可服务的端口不通。解法是逐条排除——用[Environment]::GetEnvironmentVariable(LM_LICENSE_FILE,Machine)读回确认写入位置新开终端验证是否刷新检查路径有无空格最后确认端口连通性。还有一个隐蔽的之前装过同系列工具环境变量里已经有旧值新值直接覆盖导致两边都失效用 3.3 节的拼接写法可以避免。提示许可问题排查时先把所有改动回退到“只有一条正确路径”的状态再逐项加回来。多个变量叠加的状态下报错信息往往指向错误的位置。6. 把 .mdl 管起来版本快照、XMI 备份与交接的三条硬规矩安装只是起点真正会疼的是模型文件的管理。.mdl 是二进制容器放进版本库既不能 diff 也不能合并两个人同时改同一个文件冲突时只能二选一。我在一个多人协作的课程设计上吃过这个亏两个人分别补了用例图和类图合并时发现谁也没法保留对方的修改最后手工重画了一遍。从那以后我定了几条规矩。第一条是“文件按人分不按图分”一个模型只归一个人维护其他人要看就导 XMI 出去看需要改就提意见由维护者统一改。第二条是“每天收工做一次带日期快照”脚本很简单但能保证任何时候都能回到昨天的状态# 每天收工快照按日期保留历史版本只留最近 14 天 $src D:\Rational\workspace\course-design.mdl $dst D:\Rational\snapshot New-Item -ItemType Directory -Path $dst -Force | Out-Null $target Join-Path $dst (course-design-{0}.mdl -f (Get-Date -Format yyyyMMdd)) Copy-Item $src $target -Force Write-Host 快照已生成: $target # 清理 14 天前的快照避免目录无限膨胀 Get-ChildItem $dst -Filter course-design-*.mdl | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-14) } | Remove-Item -Force脚本里-Force是覆盖写同一天跑两次不会生成重复文件清理那段的-14可以按课程周期调整两周的课设留 14 天够用跨学期的项目建议留 30 天。第三条规矩是“关键节点导一次 XMI”答辩前、交给导师前、和别人的模型合并前都导一份 XMI 存档。XMI 是文本格式能进版本库、能 diff、也不会因为软件版本升级而打不开相当于给自己留了个后悔药。交接给别人时我给的不只是一个 .mdl而是一个目录model/放当天的 .mdlxmi/放最近一次导出readme.txt写清楚用的是哪个版本、许可怎么配、哪些图还没画完。这三样东西加起来接手的人半小时内能跑起来不用来回问。装完这套工具之后最该养成的习惯其实是这个——每次交付前把环境自检、模型快照、XMI 导出这三步强制走一遍比任何补救都快。希望帮到你。本文还有配套的精品资源点击获取