DBeaver连接名即实际备注名，需有意义地命名以区分环境，如“? dev-mysql”或“? prod-readonly”，它出现在导航树、标签页、导出文件名及日志中；命名应避免模糊词，支持中文、emoji但禁用斜杠，修改后须点击Finish并重连生效。
连接名就是备注名，DBeaver 本身不提供独立“备注字段”，但连接名称（Name）是你唯一能直接看到、搜索、区分环境的标识，必须起得有意义。
为什么不能随便填“MySQL连接1”
连接名称会出现在左侧导航树顶部、标签页标题、导出文件名、SQL编辑器右下角状态栏，甚至在日志和错误提示里反复出现。一旦起成“新建连接”或“MySQL-1”，后面连了七八个库，光靠颜色/图标根本分不清哪个是测试库、哪个是带 SSL 的生产只读库。
- 它不是装饰字段，而是你日常操作中第一个要识别的信息
- 重命名操作成本极低（右键 → 编辑连接 → 修改
Name），但起错名带来的误操作风险很高 - 版本 22.3+ 支持在连接名里用空格、中文、emoji（如 ? dev-mysql / ? prod-readonly），但不要含斜杠
/或反斜杠\，否则可能干扰路径解析
推荐的命名结构与实际填法
直接在新建连接或编辑连接窗口的 Name 输入框里写，不是在“驱动属性”或“高级设置”里找备注栏。
- 按环境 + 类型 + 实例：例如
dev-mysql8-local、test-pg15-ssh、prod-oracle19-rac - 加视觉标记：开头用 emoji 或前缀快速筛选，比如
[DEV] mysql-dev、? prod-readonly - 避免模糊词：“test”不如“test-payment-db”明确，“old”不如“legacy-oracle-11g”可追溯
- 如果连接用于特定任务（如数据迁移），可加入用途，例如
migration-sqlserver-to-mysql
连接名改完不生效？检查这三个地方
改了 Name 却发现导航树还是旧名字，大概率是没点“完成”或漏了保存步骤。
- 编辑连接后，必须点击窗口右下角的
Finish（不是Cancel或直接关窗） - 如果连接已打开，改名后需要右键该连接 →
Disconnect再 →Connect才刷新显示 - 某些老版本（Name，重启 DBeaver 才能完全同步到标签页标题
真正容易被忽略的是：连接名一旦用于自动化脚本（比如用 DBeaver CLI 导出结构）、或被团队共享配置（.dbeaver-data-sources.json 文件），就不再是个人习惯问题，而是协作契约。起名时多花十秒，能省掉后续所有人翻日志查 IP 和端口的时间。
