直接安装 NuGet 包即可在 .NET Framework 4.5.1+ 项目中使用 Dapper，执行 Install-Package Dapper；若为 4.0 则需 Install-Package Dapper -Version 1.50.5，并引用 using Dapper;，通过 IDbConnection 实例调用扩展方法，支持命名参数防 SQL 注入，兼容旧数据层但需避免连接复用与混用。
直接安装 NuGet 包即可开始使用
在 .NET Framework 项目中集成 Dapper 非常简单，不需要额外配置运行时或修改项目文件（只要版本 ≥ 4.5.1）。打开 Visual Studio 的“包管理器控制台”，执行：
- Install-Package Dapper —— 安装最新稳定版（支持 .NET Framework 4.5.1 及以上）
- 如果项目用的是较老的 .NET Framework 4.0，可安装旧版：Install-Package Dapper -Version 1.50.5
引用命名空间并确认连接可用
在代码文件顶部添加：
using Dapper;
确保你已有 IDbConnection 实例（比如 SqlConnection），Dapper 所有扩展方法都挂在这个接口上。常见写法：
- 用 using (var conn = new SqlConnection(connectionString)) 确保及时释放
- 不要复用未关闭的连接，Dapper 不负责连接生命周期管理
- 连接字符串建议从 ConfigurationManager.ConnectionStrings 读取
基础查询与参数化防 SQL 注入
Dapper 默认使用命名参数（推荐），自动处理类型映射和参数转义：
- conn.Query<User>("SELECT * FROM Users WHERE Id = @id", new { id = 123 })
- 多个参数直接传匿名对象：new { name = "张三", status = 1 }
- 避免拼接字符串，不写
"WHERE Id = " + id—— 这会绕过参数化，引发安全风险
注意老项目常见兼容问题
部分传统 .NET Framework 项目可能存在以下情况，需手动检查：
- 目标框架是 .NET Framework 4.0 或更低 → 必须降级到 Dapper 1.50.x 版本
- 项目启用了 嵌套类型（Nested Types）或 COM 互操作 → 确保 Dapper 引用无冲突，可尝试清理 bin/obj 后重装
- 使用了 Enterprise Library、LINQ to SQL 等旧数据层 → Dapper 可共存，但别混用同一连接实例做并发操作
基本上就这些。Dapper 本身只是一个轻量扩展库，不改写你的连接逻辑，也不依赖 DI 容器，老项目接入零侵入。
