必须三值接收image.Decode返回值，否则格式未注册时会静默返回nil图像和nil错误，导致后续Bounds()等调用panic；format用于保存分支判断，WebP需手动导入扩展包；缩放须用x/image/draw，JPEG保存必须显式传jpeg.Options。
image包解码必须三值接收，否则静默失败
Go标准库不抛异常，image.Decode返回三个值：图像、格式名、错误。只取第一个值（img, _ := image.Decode(f)）会导致格式未注册时返回nil图像 + nil错误，程序继续运行但后续img.Bounds() panic。这不是bug，是设计——格式名是解码器选择依据，也是保存时的逻辑分支来源。
- 始终用三值接收：
img, format, err := image.Decode(f) - 检查
err != nil，而不是img == nil - 若需WebP支持，必须显式导入
golang.org/x/image/webp并调用webp.Decode，标准库不含该格式 -
format字符串可直接用于后续保存分支：if format == "jpeg" { jpeg.Encode(...) }
缩放别手写双线性插值，用x/image/draw
手动遍历像素实现缩放不仅代码量大，还容易因坐标映射错误导致拉伸变形或黑边。Go官方扩展包golang.org/x/image/draw已封装好多种重采样算法，精度与性能兼顾，且适配所有image.Image实现。
- 目标图必须预先创建：
dst := image.NewRGBA(image.Rect(0, 0, w, h)) - 用
draw.Bilinear（质量优先）或draw.NearestNeighbor（速度优先，适合图标） - 注意源图和目标图的
Bounds()不能混用：src.Bounds()是原始尺寸，不是image.Rect(0,0,w,h) - 极小缩略图可用
draw.ApproxBiLinear提速，但质量略低于Bilinear
JPEG保存必须传*jpeg.Options，Quality不能省
jpeg.Encode若传nil选项，在Go 1.20+版本会panic；不传选项则用默认DefaultQuality = 75，但该值在历史版本中变动过，且不同场景下需求差异大（如网页缩略图要快，印刷输出要高保真）。
- 显式构造选项：
&jpeg.Options{Quality: 90} - Quality范围是1–100，50以下明显失真，95以上体积陡增但视觉提升有限
- PNG无Quality参数，但可通过
&png.Encoder{CompressionLevel: flate.BestSpeed}控制压缩速度 - 务必
defer关闭文件句柄，否则并发场景下可能耗尽文件描述符
CGO调用CUDA/OpenCV前先确认环境链路通
CGO不是开关，而是编译期桥接。CGO_ENABLED=1只是前提，真正卡住的是C工具链、头文件路径、动态库链接三者是否对齐。很多“调用失败”实际是编译阶段就中断，但日志被掩盖。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env CGO_ENABLED确认输出为1；非1则执行go env -w CGO_ENABLED=1 - Linux/macOS检查开发包是否安装：
libopencv-dev、libmagickwand-dev、nvidia-cuda-toolkit - Windows用户必须装MinGW-w64（推荐MSYS2），且
gcc --version能在终端直接执行 - 在
// #cgo指令中显式声明路径：// #cgo CFLAGS: -I/usr/local/cuda/include、// #cgo LDFLAGS: -L/usr/local/cuda/lib64 -lcudart
CGO_ENABLED开了却没装gcc，或是jpeg.Decode漏了第二个返回值导致格式识别失败——这些点不提前踩实，后面所有图形逻辑都建在流沙上。 
