Npgsql可直接安全高效操作PostgreSQL，关键在参数配置、SQL写法与类型匹配：需按.NET版本选兼容Npgsql包（如net461用3.2.7），连接字符串须显式设Port和sslmode，参数化查询用冒号语法（:name）且严格区分大小写，批量插入推荐UNNEST或多行VALUES，禁用字符串拼接防注入，务必用using管理资源并确保参数名一致。
直接用 Npgsql 就能操作 PostgreSQL，不用 ORM 也能安全、高效读写——关键不是“能不能连上”，而是参数怎么设、SQL 怎么写、类型怎么对。
安装 Npgsql 包必须匹配 .NET 版本
新版 Npgsql（比如 8.x）默认要求 .NET 6+；如果你还在用 C# 6.0（对应 .NET Framework 4.6.1），得锁死旧版本：
-
Install-Package Npgsql -Version 3.2.7是兼容 .NET Framework 4.6.1 的最后稳定版 - 别直接
dotnet add package Npgsql，它默认装最新版，运行时会报Could not load file or assembly 'Npgsql, Version=8.0.0.0' - 检查项目属性里的目标框架：要是显示
net461或net472，就别碰 7.x/8.x
连接字符串里 Port 和 sslmode 容易漏配
本地开发常省略 Port=5432，但一旦换端口（比如 Docker 映射成 5433）或上云（Azure 要求 sslmode=require），不显式写就会连不上：
- 本地测试可简化：
Host=localhost;Database=mydb;Username=postgres;Password=123456; - 远程或云环境必须加全：
Host=mydemoserver.postgres.database.azure.com;Port=5432;Database=mydb;Username=admin@mydemoserver;Password=xxx;sslmode=require; -
Username在 Azure 上要带 @server-name 后缀，漏掉就报Invalid username format
参数化查询必须用冒号 :name，不是 @name
Npgsql 不认 SQL Server 风格的 @param，硬写会触发 42703: column "name" does not exist 错误：
- 正确写法：
"INSERT INTO users (name, age) VALUES (:name, :age)"，然后cmd.Parameters.AddWithValue(":name", "Alice") - 大小写敏感：
:Name≠:name，命名不一致会导致参数未绑定，值变成 NULL 或类型错乱 - 传
null时别用AddWithValue，它可能推断成int导致Can't write CLR type System.DBNull with handler type Int4Handler；改用cmd.Parameters.Add(":age", NpgsqlDbType.Integer).Value = DBNull.Value;
批量插入别拼字符串，用 UNNEST 或多行 VALUES
循环执行 INSERT 一百次，性能比一次插百条慢 10 倍以上，而且容易超连接池限制：
- 推荐用
UNNEST：INSERT INTO logs (msg, ts) SELECT * FROM UNNEST(:msgs, :tss)，然后传两个string[]参数 - 或用多行
VALUES：INSERT INTO users (name, age) VALUES (:n1, :a1), (:n2, :a2), ...，但注意 PostgreSQL 单次最多支持约 32k 参数，别硬塞几千个 - 别手拼
"INSERT ... VALUES ('" + name + "', " + age + ")"，SQL 注入风险高，且中文、单引号直接崩
最常被忽略的是连接释放时机和参数命名一致性——using 块没包住 NpgsqlCommand，或者 SQL 里写 :user_name 却传 :username，这种错误不会编译报错，但查半天数据没进去。
