默认导出png模糊是因为plantuml本地jar默认使用72 dpi,需在vscode中配置plantuml.jarargs为["-dpi", "300"]并指定正确jar路径,重启后通过命令面板导出验证dpi是否生效。

默认导出的PNG是低分辨率的,必须显式配置DPI参数才能得到高清图。
为什么导出的PNG看起来模糊
PlantUML插件默认使用72 DPI渲染PNG,这仅够屏幕显示,打印或嵌入文档时明显发虚。根本原因不是插件问题,而是底层plantuml.jar在无显式参数时采用保守默认值。即使你已配好Graphviz和Java,不改DPI参数,预览再清晰,导出仍是模糊PNG。
- VSCode预览窗口用SVG渲染(矢量,无限缩放),容易误判导出质量
- 导出PNG动作实际调用
java -jar plantuml.jar命令,DPI需通过-dpi参数传入 - 在线渲染服务(如默认
https://www.plantuml.com/plantuml)不支持自定义DPI,必须走本地jar
必须配置plantuml.jar路径并启用dpi参数
插件本身不提供DPI设置UI,只能通过VSCode设置项注入命令行参数。关键步骤是:确保plantuml.jar路径正确,并在plantuml.jarArgs中加入-dpi 300(推荐值)。
- 下载最新
plantuml.jar(从https://plantuml.com/download),存到固定路径,例如/opt/plantuml/plantuml.jar - VSCode设置中搜索
plantuml.jar,填入绝对路径(Windows用C:/plantuml/plantuml.jar) - 搜索
plantuml.jarArgs,设为["-dpi", "300"](注意是JSON数组格式,双引号不能少) - 重启VSCode,新建
test.puml,写个简单时序图测试导出
导出操作与验证方法
导出动作本身不暴露DPI选项,必须用命令面板触发,且要确认输出文件是否真含高DPI元数据。
- 打开
.puml文件,按Ctrl+Shift+P(macOS用Cmd+Shift+P),输入PlantUML: Export Current Diagram - 选择
PNG格式,保存后用系统图片查看器“实际像素”模式打开,放大到200%看文字边缘是否锐利 - 更准的验证方式:终端执行
file your-diagram.png,应显示300 dpi;或用identify -format "%x x %y" your-diagram.png(ImageMagick) - 若仍模糊,检查
plantuml.jarArgs是否拼写错误,或是否误填在plantuml.server等无关设置项里
最容易被忽略的是plantuml.jarArgs必须是合法JSON数组,写成"-dpi 300"字符串或漏掉引号都会让参数失效——插件静默忽略错误参数,导出行为退回到72 DPI。











