VSCode搭配CMake开发SDL2时IMG_Load加载PNG提示无法打开文件
Couldn't open ./Images/Mountain.png报错与依赖链接、编译配置无关,本质是程序运行时的默认工作目录,和代码中相对路径的预期基准不匹配。
在Windows + MSVC构建工具 + VSCode CMake扩展的组合下,CMake默认生成的可执行文件会存放在构建目录(一般是项目根目录下build/子文件夹内的Debug/Release层级),VSCode CMake扩展默认启动程序的工作目录就是可执行文件所在的文件夹,而非项目根目录。
代码中书写的./Images/Mountain.png为相对路径,程序会从当前工作目录逐层查找,实际查找路径会变为build/Debug/Images/Mountain.png,无法匹配存放在项目根目录下Images文件夹内的图片文件。
1. 调整VSCode CMake运行配置
- 打开VSCode设置,找到
cmake.debugConfig配置项,新增工作目录指定:
{ "cmake.debugConfig": { "cwd": "${workspaceFolder}" } }
配置生效后,启动程序时会自动把工作目录切换到项目根目录,相对路径就能正确匹配图片存放位置。
2. 从CMake层面固化工作目录配置
在CMakeLists.txt的add_executable语句后面新增一行配置,适配MSVC构建工具的调试场景:
# 设置MSVC调试器启动程序时的工作目录为项目源码根目录 set_target_properties(${PROJECT_NAME} PROPERTIES VS_DEBUGGER_WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}")
该配置对直接通过VS打开生成的解决方案文件调试的场景同样生效,不需要每次手动调整路径。
3. 快速排查路径偏差
可以在main函数的起始位置添加代码,直接打印程序运行时的实际工作目录,直观确认查找路径的基准位置:
#include <direct.h> // Windows平台专用头文件 // ... int main(int argc, char const *argv[]) { char* currentPath = _getcwd(NULL, 0); std::cout << "程序当前工作目录: " << currentPath << std::endl; free(currentPath); // 后续原有业务代码... }
现有代码中IMG_Load返回空指针时,仍会继续调用SDL_CreateTextureFromSurface和SDL_FreeSurface传入空指针,虽然不会直接触发崩溃,但会产生无意义的SDL调用,建议补全空指针判断逻辑:
SDL_Surface *tempSurface = IMG_Load("./Images/Mountain.png"); if (!tempSurface) { std::cout << "Can't load image! Error: " << IMG_GetError() << std::endl; // 补充错误退出逻辑,终止后续空指针调用 return -1; } tex = SDL_CreateTextureFromSurface(renderer, tempSurface); SDL_FreeSurface(tempSurface);
内容的提问来源于stack exchange,提问作者Thinh Tran

