EasyX初始化失败主因是编译器不兼容或字符集错误：仅支持VS（MSVC）且须选Unicode字符集；initgraph()必须在main()开头调用并配_T宏，配合_getch()防闪退；双缓冲需setrendermode+Begin/EndBatchDraw；键盘输入须用VK_虚拟键码与0x8000位判断；图片路径应相对于工作目录而非源码目录。
EasyX 初始化失败：找不到 initgraph() 或黑窗口一闪而过
绝大多数新手卡在这一步——程序编译通过但没图形窗口，或者直接崩溃。根本原因是 EasyX 仅支持 Visual Studio 编译器（MSVC），且必须用 Unicode 字符集 和 多字节字符集都不行。VS 新建项目时，在“常规 → 字符集”里务必选“使用 Unicode 字符集”。
初始化代码不能写在全局或任意位置：initgraph() 必须在 main() 开头调用，且需指定宽高和窗口标题：
int main() {
initgraph(640, 480, _T("我的小球游戏")); // 宽、高、标题（_T宏必需）
// 后续绘图代码...
_getch(); // 防止窗口关闭（按任意键继续）
closegraph();
return 0;
}
- 忘记
_getch()或getchar()：控制台窗口会立即退出，图形根本看不到 - 用 MinGW / Clang / VS 的“Linux 控制台”模板：链接失败，
initgraph找不到符号 - 在 Windows Terminal 或 VS Code 终端里运行：EasyX 只支持原生 Win32 窗口，终端环境不兼容
画圆移动但卡顿严重：没用双缓冲，也忘了 BeginBatchDraw() 和 EndBatchDraw()
直接在 while 循环里反复调用 circle() + delay()，画面撕裂、闪烁、掉帧。EasyX 默认是单缓冲，每次绘图都直接刷屏。
正确做法是启用双缓冲并批量提交：
立即学习“C++免费学习笔记（深入）”；
setrendermode(RENDER_MANUAL); // 关闭自动刷新
BeginBatchDraw();
while (running) {
cleardevice(); // 清屏（在缓冲区里清）
circle(x, y, 20); // 绘制（仍在缓冲区）
x += dx; y += dy;
EndBatchDraw(); // 一次性把整个缓冲区刷到屏幕
delay(16); // 约 60 FPS
}
- 漏掉
BeginBatchDraw()：EndBatchDraw()无效，仍闪烁 - 用
FlushBatchDraw()替代EndBatchDraw()：功能相同，但语义上End更符合“成对”直觉 - 延迟设成
delay(1)：CPU 占满 100%，且实际帧率不可控；固定 16ms 是底线，再快人眼难分辨
键盘响应失灵：用 GetAsyncKeyState() 但没处理虚拟键码
想实现“按方向键移动角色”，却写 if (GetAsyncKeyState('A')) —— 这只能捕获大写 A，且不区分按下/释放。EasyX 不提供高级输入封装，得直接对接 Windows API。
方向键、空格、ESC 等都不是 ASCII 字符，要用 虚拟键码：
if (GetAsyncKeyState(VK_LEFT) & 0x8000) x -= 5; // 持续按下才生效 if (GetAsyncKeyState(VK_SPACE) & 0x8000) jump = true;
- 只写
GetAsyncKeyState(VK_LEFT)：返回值是 short，高位为 1 表示“当前正按下”，必须与0x8000按位与判断 - 误用
GetKeyState()：它返回的是“上次消息循环时的状态”，不适合实时游戏 - 没做防连击：快速连按一次可能触发多次跳跃，需加标志位或计时器
图片资源加载失败：loadimage() 返回空指针，路径和格式全对还是白屏
常见现象：loadimage(NULL, _T("player.png")) 返回 NULL，但文件明明在工程目录下。问题往往出在工作目录和编码上。
EasyX 加载图片时，路径是相对于进程当前工作目录，不是源码目录。VS 默认工作目录是项目目录（含 .vcxproj 的地方），不是 Debug/Release 文件夹。
- 把图片放进
Debug/目录，然后用loadimage(NULL, _T("player.png")) - 用绝对路径调试：
loadimage(NULL, _T("C:\mygame\player.png"))，确认是否路径问题 - PNG 透明通道不生效：EasyX 默认不开启 alpha 混合，需手动调用
setalpha()或用drawimage()的扩展参数 - GIF 动画不支持：EasyX 只读静态帧，
loadimage()对 GIF 只取第一帧
资源加载失败几乎从不报错，loadimage() 返回 NULL 就是唯一线索，务必检查返回值。
