Drawio文件协作规范

命名约定

• 使用小写字母和连字符：system-architecture.drawio
• 添加版本号：database-schema-v2.drawio

提交信息格式

• [ADD] 添加新图表
• [MOD] 修改现有图表
• [FIX] 修复图表错误
• [REF] 重构图表结构

分支策略

• main 分支保持可导出状态
• 功能分支命名：feature/图表名称

### 3.3 集成开发环境工作流

将drawio-desktop与代码编辑器集成，实现文档与代码的联动：

```json
// VS Code配置示例 (.vscode/settings.json)
{
  "files.associations": {
    "*.drawio": "drawio"
  },
  "drawio.exportFormat": "svg",
  "drawio.exportPath": "${workspaceFolder}/docs/images"
}

四、效率提升工具与插件

📝 笔记：扩展drawio-desktop功能的实用工具

4.1 绘图辅助插件

1. Drawio Themes - 提供多种专业配色方案，一键切换图表风格
2. Shape Libraries - 扩展形状库，增加行业特定图形（如AWS、Kubernetes图标）
3. Diagram Linter - 检查图表合规性，确保团队风格一致
4. Keyboard Shortcuts Manager - 自定义快捷键，提高操作效率

4.2 自动化工具集成

1. Drawio CLI Wrapper - 更友好的命令行界面，简化批量操作
2. Git Hooks Integration - 提交前自动导出图表为指定格式
3. CI/CD Pipeline Plugin - 集成到持续集成流程，自动生成文档

4.3 常见操作对比表

操作	图形界面	命令行	效率对比
单文件导出	3步点击操作	1条命令	命令行快3倍
批量导出	重复操作N次	1条命令	命令行快N倍
格式转换	另存为不同格式	-f 参数指定	命令行快2倍
页面选择	手动选择导出	-p 参数指定	命令行快5倍

五、高级配置与优化

💡 技巧：释放drawio-desktop全部潜力

5.1 性能优化配置

# 禁用硬件加速（解决某些显卡兼容性问题）
drawio --disable-gpu

# 增加内存限制
export ELECTRON_ENABLE_LOGGING=1
export ELECTRON_NO_ATTACH_CONSOLE=1
drawio --js-flags="--max-old-space-size=4096"

5.2 自定义配置文件

创建~/.drawiorc文件进行高级设置：

{
  "defaultFormat": "pdf",
  "exportQuality": 90,
  "recentFiles": 20,
  "defaultTemplate": "basic-flowchart",
  "enableSpellCheck": true,
  "autoSaveInterval": 300,
  "theme": "dark"
}

5.3 数据备份与迁移

# 备份配置和模板
tar -czf drawio-backup.tar.gz ~/.config/draw.io/

# 迁移到新系统
scp drawio-backup.tar.gz user@new-system:~
ssh user@new-system "tar -xzf drawio-backup.tar.gz -C ~/.config/"

六、常见问题诊断与解决

⚠️ 警告：遇到问题先检查这些方面

6.1 启动问题排查

# 查看日志
drawio --enable-logging > drawio.log 2>&1

# 重置配置
rm -rf ~/.config/draw.io/

# 检查依赖
ldd $(which drawio) | grep "not found"  # Linux系统

6.2 导出失败解决方案

1. 文件权限问题：确保输出目录可写

   chmod 755 ./exports
   

2. 字体缺失：安装必要字体

   # Ubuntu/Debian
   sudo apt-get install ttf-mscorefonts-installer