ImageSharp实现P-Hash需三步：缩放至32×32并用Box重采样、按亮度公式转灰度、对8×8 DCT子块取中位数生成64位哈希，推荐存为ulong并用PopCount快速比对。
用 GetPerceptualHash 计算图片 P-Hash 在 C# 里不直接存在
标准 .NET 没有内置的 GetPerceptualHash 或类似方法。你得自己实现，或依赖第三方库。最常用、最稳的是 ImageSharp + 手写 P-Hash 算法逻辑——它比 System.Drawing 更安全、跨平台，且不会因 GDI+ 崩溃或抛出 OutOfMemoryException。
别碰 System.Drawing.Common 在 Linux/macOS 上的非官方支持，尤其在容器或高并发场景下，System.ArgumentException: Parameter is not valid 出现频率极高。
- 用
ImageSharp加载图片后缩放到32x32（P-Hash 标准尺寸） - 转灰度，不是简单取 RGB 平均值，而是用亮度公式：
0.299*R + 0.587*G + 0.114*B - 做 DCT 变换时，只取左上
8x8块——这是 P-Hash 的核心压缩步骤，不是全图 DCT - 计算这 64 个 DCT 系数的中位数，再逐个比较：≥中位数为 1，否则为 0，拼成 64 位二进制字符串
ImageSharp 下实现 P-Hash 的关键三步
你不需要引入整个图像处理生态，只要 Pomelo.EntityFrameworkCore.MySql 这种“名字吓人但其实很轻”的错觉——ImageSharp 的 P-Hash 实现，核心代码不到 50 行。
常见翻车点：DCT 库选错。MathNet.Numerics 的 DctForward 默认是行优先二维变换，但你要的是对 8×8 子块做二维 DCT，必须确保输入是 double[8,8] 而非 double[64]，否则结果全乱。
- 缩放必须用
ResizeMode.Box（盒式重采样），不是Lanczos3——后者会引入高频噪声，导致哈希误判 - 灰度转换必须用
KnownResamplers.Lanczos3配合ColorSpaceConversion.ToGrayscale，不能靠pixel.R * 0.299 + ...手动算——ImageSharp的像素结构是 BGRA，顺序错了就全偏 - 最后生成的哈希建议存为
ulong（64 位），而不是字符串或byte[]：比对时用bitCount = System.Numerics.BitOperations.PopCount(a ^ b)，比字符串逐字符比较快 20 倍以上
哈希比对时 bitCount > 5 就算明显不相似？不一定
阈值不是拍脑袋定的。同一张图旋转 90°、加 10% JPEG 压缩、裁剪掉右下角 1/4，P-Hash 差异可能在 3~7 位之间浮动。所以 bitCount 才算高度相似，<code>4~7 得人工复核或加二级校验（比如直方图交集）。
更麻烦的是缩略图场景：小图（如 100×100）强行放大到 32×32 再算 P-Hash，会产生大量伪边缘，导致哈希完全失真——这时候应该先判断原始尺寸，width 就跳过 P-Hash，改用平均哈希（<code>AHash）。
- 批量比对 1000 张图时，别用嵌套循环暴力算
O(n²)，先按哈希前 16 位分桶，只在同桶内比对 - 数据库存哈希别用
varchar(64)，用binary(8)或ulong字段，索引效率差 3 个数量级 - Web API 返回相似图列表时，别把 64 位哈希原样透出给前端——泄露哈希等于变相泄露图片指纹，至少做一次
XXH3.Hash64单向混淆
为什么不用现成的 OpenCvSharp？
因为重。一个 OpenCvSharp4 包带 100MB+ 本地 DLL，部署到 Alpine 容器要额外装 glibc 和 libglib，CI 构建时间翻倍。而纯 C# 的 ImageSharp 实现，发布后单文件只有 12MB，零运行时依赖。
但如果你已经在用 OpenCV 做其他图像任务，那直接调 Cv2.PHash 最省事——注意它返回的是 Mat 类型，得用 mat.GetDouble(0, 0) 提取 64 位整数，不是直接 ToString()。
-
Cv2.PHash默认用 32×32+8×8 流程，和标准一致，但底层用的是浮点 DCT，和整数版略有差异，跨库比对前务必统一实现 - Windows 上
OpenCvSharp的cv2.pHashPython 绑定名不同，C# 里是Cv2.PHash，别搜错函数名 - 如果发现哈希总一样（全是 0 或全是 1），大概率是图片加载失败，
Cv2.ImRead返回 null 但没判空——这种错误不抛异常，只会静默填零
P-Hash 看似只是“算个哈希”，但缩放方式、DCT 实现、灰度转换顺序、甚至像素内存布局，任意一环偏差都会让结果不可比。真正上线前，一定要拿同一张图的 JPEG/WEBP/PNG 三种格式各生成 10 组哈希，看它们两两之间的汉明距离是否稳定在 0~2 位。
