Eclipse中PlantUML插件更新后无法识别SysML v2文件求助

排查与解决步骤 #

1. 确认SysML v2语法合规性 #

新版PlantUML Library（1.2023.10）对SysML v2语法有严格要求，先检查你的文件：

• 必须在@startuml后添加!pragma sysml version=2声明版本
• 摒弃旧版插件兼容的废弃语法，比如过时的元素定义方式

2. 修复文件扩展名关联 #

• 打开Eclipse偏好设置，进入General > Editors > File Associations
• 分别查找.sysml2、.sysml和.puml，确认默认编辑器为PlantUML Editor
• 若未关联，点击「Add」添加对应扩展名，再设置PlantUML Editor为默认

3. 重装插件确保完整性 #

• 卸载现有插件：打开Help > About Eclipse > Installation Details，选中PlantUML相关组件点击「Uninstall」
• 重启Eclipse后，通过官方P2站点重新安装完整插件包，确保包含SysML v2支持组件
• 安装完成后再次重启Eclipse，测试文件识别

4. 验证插件版本兼容性 #

• 确保PlantUML Feature（1.1.29）与Library（1.2023.10）版本匹配，避免版本不兼容导致功能缺失
• 更新时勾选「Group items by category」，同步更新所有PlantUML相关组件

5. 用最小化文件测试 #

创建极简SysML v2文件（保存为.sysml2或.puml）测试：

@startuml
!pragma sysml version=2

package "Test SysMLv2" {
  part def TestPart {
    attribute name : String
  }
}
@enduml

若该文件能正常渲染，说明原始文件存在语法问题；若仍无法识别，需检查插件安装是否完整。

内容的提问来源于stack exchange，提问作者user8039286