EasyX是仅支持Visual Studio的Windows GDI封装库,需Unicode字符集、initgraph()初始化、左上原点坐标系、RGB()宏设色,且绘图函数必须在initgraph()后、closegraph()前调用。

EasyX 不是 C++ 标准库,也不能直接用 g++ 或 cl.exe 默认编译通过——它本质是 Windows 平台的 GDI 封装库,只支持 Visual Studio(MSVC)编译器,且必须使用 Unicode 字符集和多字节字符集兼容模式。
EasyX 要求 VS 编译环境,不支持 MinGW / Clang / Code::Blocks
你写好 #include 后如果报错 “cannot open source file 'easyx.h'”,大概率是因为:
- 没装 Visual Studio(至少 VS 2015 及以上),或没装 C++ 桌面开发工作负载
- 没下载安装 EasyX(官网 easyx.cn 下载的是 .exe 安装包,不是头文件压缩包)
- 项目属性里字符集设成了“未设置”或“多字节”,必须设为 “使用 Unicode 字符集”
- 新建项目时选了“空项目”但没手动添加
main()入口,或用了int main()却没关预编译头(VS 默认开 /Yu,会报找不到stdafx.h)
初始化窗口必须调用 initgraph(),且不能在全局作用域
initgraph() 是 EasyX 的入口函数,负责创建绘图窗口并初始化设备上下文。它不能写在全局、不能写在类定义里、也不能在 main() 外调用。
常见错误写法:
立即学习“C++免费学习笔记(深入)”;
// ❌ 错误:全局调用
initgraph(640, 480);
int main() { ... }
// ✅ 正确:在 main 开头立即调用
int main() {
initgraph(640, 480); // 宽640,高480,自动创建窗口
// 后续 draw 系列函数才能生效
circle(320, 240, 100);
_getch(); // 等待按键,否则窗口一闪而过
closegraph(); // 必须配对调用
return 0;
}
注意:initgraph() 第三个参数可选指定窗口标题,如 initgraph(640, 480, _T("我的图形"));若省略,标题默认为 “EasyX Graphics Window”。
坐标原点在左上角,Y 轴向下增长,和数学习惯相反
EasyX 使用屏幕坐标系:左上角是 (0, 0),x 向右增大,y 向下增大。这意味着:
-
line(0, 0, 100, 100)画的是从左上到右下的斜线,不是左下到右上 -
outtextxy(x, y, _T("Hello"))的y值越大,文字越靠下,容易误判位置 - 想模拟数学坐标系?得自己做坐标变换,比如把
y' = height - y,但 EasyX 不提供自动翻转 API
绘图前建议先用 setorigin() 移动原点,或用 setviewport() 配合 setwindow() 模拟逻辑坐标,不过这些属于进阶用法,新手先适应左上原点更稳妥。
颜色值用 RGB() 宏,别直接传 0xFF0000 这类十六进制数
EasyX 的颜色参数类型是 COLORREF,推荐用 RGB(r, g, b) 宏生成,而不是手写 0xFF0000 —— 因为 Windows GDI 是 BGR 排序(蓝、绿、红),0xFF0000 实际显示为蓝色,不是红色。
正确写法:
// ✅ 清晰安全 setcolor(RGB(255, 0, 0)); // 红色 setfillcolor(RGB(0, 255, 0)); // 绿色// ❌ 危险:0xFF0000 是 BGR,实际为 blue=0xFF, green=0x00, red=0x00 → 显示蓝色 setcolor(0xFF0000); // 别这么写
另外,setbkcolor() 设置背景色后,需配合 cleardevice() 才真正刷屏;而 setbkmode(TRANSPARENT) 可让文字背景透明,避免遮盖已有图形。
最容易被忽略的一点:EasyX 所有绘图函数(circle、rectangle、fillcircle 等)都依赖当前设备上下文,而该上下文只在 initgraph() 成功后存在。一旦 closegraph() 被调用,再执行绘图就会触发断言失败或黑屏——所以别在 closegraph() 后还试图画东西。










