Dapper 不原生支持执行 SQL 脚本文件，需手动读取、清理注释、按分号拆分语句（跳过 GO），再逐条调用 Execute 执行，建议包裹在事务中确保原子性。
直接用 Dapper 执行 SQL 脚本文件（比如 .sql 文件）不是它原生支持的功能，Dapper 本身只提供单条 SQL 的执行能力（Execute、Query 等）。但你可以轻松组合 C# 基础能力 + Dapper 实现“批量执行 SQL 脚本”，关键是把脚本拆成独立语句再逐条交给 Dapper。
读取并解析 SQL 脚本文件
SQL 脚本通常包含多条语句，用分号 ; 分隔，可能还有注释（-- 或 /* */）。Dapper 不处理这些，需自己清理和分割：
- 用
File.ReadAllText("script.sql")读取整个文件内容 - 先移除行内注释（
--后到行尾）、块注释（/*...*/），避免误切分 - 按
;拆分，过滤掉空行和纯空白语句 - 注意：SQL Server 的
GO不是标准 SQL，Dapper 不识别，需提前替换或跳过（GO是 SQL Server Management Studio 的批处理分隔符，不是 T-SQL 语句）
用 Dapper.Execute 批量执行每条语句
拆出有效语句后，遍历执行即可。推荐用事务包裹，确保全部成功或全部回滚：
- 打开连接，开启事务：
using var tx = connection.BeginTransaction(); - 对每条非空语句调用：
connection.Execute(sql, transaction: tx); - 全部成功后调用
tx.Commit()；任一失败则tx.Rollback()（建议用 try-catch 包裹） - 注意：不能在一个 Execute 中传入含多个分号的字符串（如
"INSERT...; UPDATE...;"），Dapper 会报错 —— 它只接受单条语句
处理带参数的脚本？Dapper 不自动替换
如果脚本里写了 INSERT INTO Users VALUES (@name, @age)，Dapper 不会自动绑定参数。你需要：
- 手动提取参数名（比如正则匹配
@\w+），构造匿名对象或IDictionary - 或者更简单：脚本中避免用参数占位符，改用字符串拼接（仅限可信环境，如部署脚本）
- 若必须参数化，可把脚本设计成模板（如
string.Format或SqlKata配合），再传给 Dapper
小技巧：封装成可复用方法
写个通用方法提升复用性，例如：
public static void ExecuteSqlScript(this IDbConnection conn, string scriptPath, IDbTransaction? tx = null)
{
var script = File.ReadAllText(scriptPath);
var statements = SplitSqlScript(script); // 自定义拆分逻辑
foreach (var sql in statements.Where(s => !string.IsNullOrWhiteSpace(s)))
{
conn.Execute(sql, transaction: tx);
}
}这样就能一行调用：conn.ExecuteSqlScript("init.sql");
基本上就这些。核心就三点：读文件 → 拆语句 → 逐条 Execute。不复杂但容易忽略注释和 GO 处理，实操时注意下就行。
