VS Code中Jupyter Notebook使用iplantuml无法生成PlantUML图求助

1. 补全PlantUML依赖工具并配置路径 #

• 安装Graphviz：iplantuml依赖Graphviz渲染图形，下载Windows版本安装后，将Graphviz的bin目录（如C:\Program Files\Graphviz\bin）添加到系统环境变量PATH，重启VS Code生效。
• 指定PlantUML Jar路径：若iplantuml未自动加载plantuml.jar，手动下载后在代码中配置：

  import iplantuml
  iplantuml.config.INITIALIZE_JAR_PATH = "你的plantuml.jar文件路径"
  

2. 修正iplantuml的正确使用方式 #

Pylance提示"iplantuml is not accessed"是因为导入后未调用相关功能，正确用法二选一：

• 方式一：初始化魔法命令后使用

  import iplantuml
  iplantuml.init_magic()
  
  %%plantuml
  @startuml
  Alice -> Bob: Authentication Request
  Bob --> Alice: Authentication Response
  @enduml
  

• 方式二：直接生成图片文件

  import iplantuml
  iplantuml.generate_png("""
  @startuml
  Alice -> Bob: Authentication Request
  Bob --> Alice: Authentication Response
  @enduml
  """, output_file="auth_diagram.png")
  

3. 对齐VS Code的Python环境 #

• 检查VS Code左下角状态栏的Python解释器，确保和安装iplantuml的环境一致（即对应~\AppData\Roaming\Python\Python312\site-packages的Python 3.12环境）。Anaconda环境能正常使用是因为其默认预装了相关依赖，独立Python环境需手动补全。

4. 避免工具混用问题 #

plantuml_magics和iplantuml是两个独立工具，不要混用：

• 若坚持使用plantuml_magics，需切换到VS Code当前使用的Python环境，执行pip install plantuml-magics完成安装；
• 更推荐使用iplantuml自带的功能，减少冲突概率。

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