Visual Studio Code(Code-OSS)无法加载PlantUML awslib库求助

操作步骤 #

1. 获取awslib库文件 #

将awslib的完整目录结构（包含mobile、compute等子目录及对应.puml文件）下载到本地，推荐保存到用户级目录避免修改系统文件：

mkdir -p ~/.local/share/plantuml/awslib
# 将下载的awslib所有内容复制到该目录，确保路径结构为 ~/.local/share/plantuml/awslib/mobile/all.puml

2. 配置PlantUML的搜索路径 #

两种配置方式任选其一：

方式一：系统级配置（需sudo权限）

将awslib复制到PlantUML jar包所在目录（该目录默认在PlantUML的classpath中）：

sudo mkdir -p /usr/share/java/plantuml/awslib
sudo cp -r ~/.local/share/plantuml/awslib/* /usr/share/java/plantuml/awslib/

方式二：用户级配置（推荐，无需权限）

创建PlantUML用户配置文件，指定include路径：

mkdir -p ~/.config/plantuml
echo '!include ~/.local/share/plantuml/awslib/' > ~/.config/plantuml/config.puml

3. 配置VS Code的PlantUML插件 #

1. 打开VS Code设置（快捷键Ctrl+,）
2. 搜索Plantuml: Includes，点击编辑 in settings.json
3. 添加awslib路径到配置：

   "plantuml.includes": [
       "${env:HOME}/.local/share/plantuml/awslib"
   ]
   

4. 确认Plantuml: Jar指向系统安装的jar包：

   "plantuml.jar": "/usr/share/java/plantuml/plantuml.jar"
   

4. 验证配置 #

在Markdown中编写测试代码，打开预览查看渲染效果：

```plantuml
!include <awslib/mobile/all.puml>
AWS_Mobile_Application -> AWS_Cognito: 用户认证

## 扩展说明
该方法同样适用于其他PlantUML精灵库（如azurelib、gcplib等），只需将对应库的目录结构放到上述指定的include路径中，重复配置流程即可。

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