skia初始化失败主因是gpu环境未正确配置：需手动传egldisplay或切vulkan，cpu渲染可用makeraster绕过；绘图需flushandsubmit()确保提交；字体需适配dpi用skfont；跨平台构建须按依赖顺序链接且补全系统库。
Skia 初始化失败：GrDirectContext::MakeGL 返回空指针怎么办
多数人卡在这一步——不是代码写错，而是环境没对。Skia 的 GPU 渲染路径依赖底层图形 API（OpenGL/Vulkan），但默认不自动探测；MakeGL 失败最常见的原因是没传入有效的 EGLDisplay 或 GLContext，尤其在无窗口环境（如服务器、离屏渲染）下直接调用会静默返回 nullptr。
实操建议：
- 先确认是否真需要 GPU：纯 CPU 绘图用
SkImage::MakeRasterCopy+SkSurface::MakeRaster更稳，绕过所有 GL 初始化 - 若必须用 GPU，在 Linux 上需手动传
eglGetDisplay(EGL_DEFAULT_DISPLAY)结果给GrGLMakeNativeInterface()，再喂给MakeGL - macOS 不支持 OpenGL 新项目，得切 Vulkan 或用
GrMtlBackendContext；Windows 上确保链接了opengl32.lib且运行时有 GPU 驱动 - 检查错误日志：启用 Skia 的调试日志（编译时定义
SK_DEBUG），失败时会输出具体原因，比如"No EGL display"或"GL version too low"
画布绘图后看不到图像：SkCanvas::flush() 和 SkSurface::getTexture() 的调用时机
Skia 是延迟提交模型，drawRect、drawPath 这些只是记录命令，不立刻执行。常见现象是内存里已有像素，但读出来全黑或旧数据——本质是没触发实际光栅化或没等 GPU 完成。
实操建议：
- CPU Surface 不需要
flush()，但必须调用surface->getCanvas()->flush()或surface->flushAndSubmit()（后者含同步）才能让结果可见 - GPU Surface 必须用
flushAndSubmit()，且之后不能立刻读像素；要读需加context->submit()+context->flush()，再等 fence 或用sk_sp<skimage> image = surface->makeImageSnapshot()</skimage> - 别在循环里反复
makeImageSnapshot()：它会触发完整拷贝，性能暴跌；优先用SkSurface::readPixels()配合预分配内存
文字渲染模糊或偏移：SkPaint 字体设置与 DPI 适配
Skia 默认按 1:1 像素密度处理字体，如果目标画布是高 DPI（比如 macOS Retina、Windows 缩放 125%），SkPaint::setTextSize(12) 会显得太小或发虚——这不是抗锯齿问题，是逻辑像素和物理像素没对齐。
实操建议：
- 用
SkFont替代老式SkPaint::setTextSize：它支持scale和edging控制，例如SkFont(font, 12 * scale)，其中scale来自系统 DPI 比值 - 开启亚像素定位：构造
SkFont时传SkFont::Edging::kSubpixel，并确保画布未启用SkCanvas::saveLayer（它会禁用亚像素） - 避免用
SkPaint::setAntiAlias(true)单独控制：字体抗锯齿由SkFont的edging和hinting决定，SkPaint的 AA 只影响几何绘制 - 中文字体注意 fallback：Skia 不自动找系统字体，
SkTypeface::MakeFromName("sans-serif", ...)在 Linux 上常失败，应预加载.ttf文件用SkTypeface::MakeFromFile("/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf")
跨平台构建报错：CMake 找不到 skia_core 或链接失败
Skia 官方不提供 install target，它的构建产物结构和符号导出规则和常规库不同。直接 find_package(Skia) 几乎总失败，错误信息像 "undefined reference to 'GrDirectContext::MakeGL'" 表面是链接问题，实则是依赖项漏了或顺序错了。
实操建议：
- 不要用第三方 FindSkia.cmake：直接 include Skia 自带的
cmake/Modules/FindSkia.cmake（需从 depot_tools 同步 skia repo 后才有） - 链接时必须按顺序：你的目标 →
skia_graphite（或skia_gpu）→skia_core→skia_images→skia_utils→ 系统库（pthread,dl,fontconfig等） - Linux 下缺
libfreetype和libpng会导致SkImageDecoder相关符号缺失，即使你不用图片解码，因为 Skia 的 core 库隐式依赖它们 - Windows 上注意运行时：Skia 默认用
/MD（动态 CRT），如果你工程用/MT，必须重新编译 Skia，否则链接时报一堆__imp__符号找不到
最麻烦的永远不是 API 调用，而是 Skia 把平台差异藏在初始化和构建里——GPU 上下文、字体加载、构建依赖这三块，任一没对齐，就会出现“代码没错但啥也不显示”的情况。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
