Steam Deck上GLFW库安装与CMake配置问题求助

核心解决方案：使用GLFW官方CMake配置 #

你的系统已存在完整的GLFW CMake配置文件（/usr/lib/cmake/glfw3），无需手动指定头文件和库路径，将CMakeLists.txt替换为以下标准配置：

cmake_minimum_required(VERSION 3.12)
project(test)

# 启用GLFW推荐的C++版本
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 自动查找系统中的GLFW库
find_package(glfw3 3.3 REQUIRED)

# 添加可执行文件
add_executable(test src/main.cpp)

# 链接GLFW目标（自动处理头文件、库依赖）
target_link_libraries(test PRIVATE glfw)

之前配置失败的原因 #

1. 手动链接库文件的问题：直接指定/usr/lib/libglfw.so时，Ninja报错找不到文件——尽管该文件是软链接，但SteamOS构建环境可能因路径解析或沙箱限制无法正确追踪。使用find_package生成的glfw目标会自动处理库的依赖关系，规避这类问题。
2. 头文件路径未生效：修改链接到具体版本库后出现头文件找不到的错误，说明手动设置的target_include_directories未被CMake正确应用，或VSCode的IntelliSense未同步配置。find_package会自动将GLFW的头文件路径添加到目标中，同时生成compile_commands.json供VSCode索引。

后续验证步骤 #

1. 清理并重新构建：删除现有build目录，重新执行配置和构建：

rm -rf build
cmake -S . -B build -G Ninja
cmake --build build

2. 修复VSCode IntelliSense：确保VSCode的C/C++插件已启用，在设置中将C_Cpp: Default Configuration Provider设为ms-vscode.cmake-tools，插件会自动读取CMake生成的compile_commands.json识别头文件和库。
3. 检查VSCode安装方式：若使用Flatpak版VSCode，沙箱限制会导致无法访问系统级的/usr/include和/usr/lib目录。建议通过Pacman安装原生VSCode：

sudo pacman -S code

额外排查点 #

• 确认GLFW版本：你安装的glfw-x11是X11后端，SteamOS默认使用Wayland，但GLFW会自动适配，无需额外配置。
• 文件权限验证：你的/usr/include/GLFW/glfw3.h和/usr/lib/libglfw.so.3.3权限正常，普通用户拥有读取权限，无需修改。

内容的提问来源于stack exchange，提问作者Petie Pete