执行.sql文件前必须确认数据库连接已就绪、脚本语法无误、目标库存在或被正确包含；需检查连接状态、CREATE DATABASE权限、UTF-8无BOM编码；整文件执行用Alt+X而非Ctrl+Enter；多文件用任务并启用事务；字符集需全局、连接级及脚本内三重保障。
直接执行 .sql 文件前，必须确认数据库连接已就绪、脚本语法无误、且目标库（或 CREATE DATABASE 语句）已存在或被正确包含——否则 90% 的失败都卡在这三步上。
执行前必须检查的三个硬性前提
很多“导入失败”根本不是 DBeaver 的问题，而是环境没对齐：
- 数据库连接必须处于“已连接”状态（左下角显示绿色圆点），不能只是“已配置”；断连后执行脚本会静默失败或报
Connection is closed -
.sql文件里如果有CREATE DATABASE，得确保当前连接用户有CREATE DATABASE权限；否则要提前手动建库，再把脚本里的CREATE DATABASE和USE xxx删掉或注释掉 - 文件编码必须是 UTF-8（无 BOM）。Windows 记事本另存为时默认带 BOM，DBeaver 读取会卡在第一行报
SQL Error [1064]；建议用 VS Code 或 Notepad++ 确认并转码
单文件执行：别用 Ctrl+Enter 全量运行
Ctrl+Enter 在 DBeaver 中默认执行「光标所在语句」，不是整个文件——这是新手最常踩的坑。整脚本乱序执行、跳过 DROP TABLE、漏建索引，全因误以为它等于“运行全部”。
- 真正执行整文件，请用
Alt+X（Windows/Linux）或Option+X（macOS），它会从头到尾逐条解析分号分隔的语句 - 如果脚本里有存储过程或函数定义（含内部
;），需先用DELIMITER $$改分隔符，否则 DBeaver 会在中间截断，报You have an error in your SQL syntax - 执行中出错时，
Alt+X会立即中断，后续语句不再跑；想继续执行得手动删掉出错语句再重来
多文件批量执行：用任务（Task）而不是拖进编辑器
把十几个 .sql 文件挨个拖进编辑器再点执行，不仅容易顺序错乱，还无法回滚——事务控制只在单次执行内有效，跨文件不成立。
- 正确做法：顶部菜单 → 窗口 → 显示视图 → 任务 → 右键空白处 → 新建任务 → 选择“SQL 脚本执行”
- 在任务配置里勾选“启用事务”，这样所有文件要么全成功，要么全回滚；不勾选就是每文件独立提交，出错后前面的已生效
- 添加多个文件时，注意拖拽调整顺序——DBeaver 按列表顺序执行，建库脚本必须排在建表脚本之前，否则报
Unknown database
脚本里含中文或特殊字符时的字符集处理
即使文件是 UTF-8 编码，DBeaver 默认可能仍按平台默认编码（如 Windows-1252）读取，导致 INSERT 中文变问号或报错。
- 全局设置：菜单 → 窗口 → 首选项 → 编辑器 → SQL 编辑器 → “SQL 文件编码”设为
UTF-8 - 连接级覆盖：右键数据库连接 → 编辑连接 → 驱动设置 → 在“连接属性”里加参数：
characterEncoding=utf8mb4（MySQL）或client_encoding=utf8（PostgreSQL） - 脚本开头显式声明（推荐）：
SET NAMES utf8mb4;或SET client_encoding TO 'utf8';，比依赖外部配置更可靠
真正麻烦的从来不是“怎么点按钮”，而是脚本是否自洽、连接是否干净、字符是否对齐——这三处一错，后面所有操作都是在无效调试。
