PlantUML需手动加\n换行,dbdiagram.io须SQL中用AS缩写字段;打印截断应改用svg2pdf.js;ER图应作为CI生成的可执行产物,用schema-crawler或Jinja2模板自动更新;大库拆解按外键依赖层级切片。
ER图导出后字段挤成一团,怎么让PlantUML或dbdiagram.io自动换行?
根本原因是多数工具默认把表结构当单行文本渲染,尤其字段名带下划线或驼峰时更易溢出。不是图没画对,是换行策略没显式声明。
- PlantUML里必须给每个
entity加{skinparam defaultFontSize 10}+ 在字段定义末尾手动加\n(注意是反斜杠+n,不是回车) - dbdiagram.io不支持自动换行,得先在SQL里用
AS缩写长字段名,比如user_created_at_timestamp AS created_at - Navicat导出PNG时勾选
Wrap column names选项,但只对当前视图生效,导出后无法再调整
分页打印ER图时,A4纸边缘总被截断,CSS @media print不管用?
因为ER图本质是SVG或Canvas渲染,浏览器打印时不会响应CSS的@media print中对width/height的重设,它只认原始SVG的viewBox和preserveAspectRatio。
- 用
svg2pdf.js替代直接打印:先用document.querySelector('svg').outerHTML取原始SVG,再传给svg2pdf(svgStr, { format: 'a4', margin: 20 }) - 如果用Mermaid,导出前在代码块顶部加
%%{init: {'theme': 'base', 'fontFamily': 'sans-serif', 'fontSize': 12}}%%,能压缩文字密度 - 别信“缩放100%”按钮——Chrome打印预览里实际要调到
Shrink to fit,否则scale: 0.8这类CSS无效
模块化管理ER图时,如何避免team成员改了表结构却忘了更新对应图文件?
靠人同步注定失败。真正可行的是把ER图当作可执行产物,而不是设计文档。
- 用
schema-crawler命令行工具,每次CI跑完mvn compile后自动执行:schemacrawler -server=postgresql -database=mydb -u user -p pass -command=schema -outputformat=png -outputfile=docs/er.png - Git钩子只校验DDL变更,不校验图片——所以要把
.png从Git移除,改用.dot或.puml源文件提交,再用CI生成图 - PostgreSQL用户可直接查
pg_tables和pg_constraint,用Jinja2模板生成PlantUML,这样字段增删会自然反映在输出里
大库(500+表)生成ER图超时或内存溢出,怎么拆解又不丢关联关系?
不是机器性能问题,是工具默认加载全库元数据再渲染。关键在“按依赖层级切片”,而不是按字母顺序分组。
- 先用
SELECT DISTINCT tc.table_name FROM information_schema.table_constraints tc JOIN information_schema.key_column_usage kcu ON tc.constraint_name = kcu.constraint_name WHERE tc.constraint_type = 'FOREIGN KEY'找出所有被外键引用的主表 - 用
pg_depend查出每张主表直接关联的3层内表(depth ),生成独立<code>subsystem_a.puml、subsystem_b.puml - 合并查看时,用PlantUML的
!include语法,在总图里只放!include subsystem_a.puml和连接线,不重复定义实体
最麻烦的其实是外键指向视图或分区表的情况——这些在information_schema里不暴露真实依赖,得去查pg_constraint.conrelid和pg_class手工映射,容易漏。


















