SFML RenderWindow 创建失败常因 OpenGL 上下文静默失败：Windows 需降级至 2.1 兼容模式，macOS Catalina+ 需 Core Profile 3.2+ 并确认 Rosetta；资源路径须匹配工作目录而非源码位置；游戏循环须分离事件、更新、渲染；精灵抖动需用 float 坐标并关闭纹理平滑。
sfml::RenderWindow 创建失败但没报错？检查窗口上下文和 OpenGL 版本
常见现象是 sf::RenderWindow 构造完后调用 isOpen() 返回 false，或后续 display() 无反应，控制台却没异常——这往往不是代码写错了，而是 SFML 在后台创建 OpenGL 上下文时静默失败。
- Windows 上默认请求 OpenGL 3.3 Core Profile，若显卡驱动老旧（比如 Intel HD Graphics 4000 或虚拟机显卡），会直接放弃创建窗口，不抛异常也不提示
- 解决方法：在创建窗口前插入
sf::ContextSettings settings(24, 8, 0, 2, 0)，把最后两个参数设为2（OpenGL 2.1）和0（Compatibility Profile），再传给RenderWindow构造函数 - macOS Catalina+ 禁用 OpenGL，必须用
settings.attributeFlags = sf::ContextSettings::Core+ OpenGL 3.2+，否则黑屏且无日志；M1/M2 芯片需确认是否启用 Rosetta（x86_64 SFML 库在原生 ARM64 macOS 下无法加载）
资源加载失败返回空纹理/字体？路径和工作目录要对得上
SFML 不管你源码里写的是 "assets/player.png" 还是 "../res/font.ttf"，它只认当前进程的工作目录（current working directory），不是可执行文件所在目录，更不是 .cpp 文件位置。
- 运行时用
std::filesystem::current_path()打印出来看看实际在哪，尤其在 VS Code、CLion 或 Qt Creator 里，工作目录默认是项目根目录，不是build/目录 - 推荐做法：把资源路径写成相对当前可执行文件的路径，用
sf::String::fromUtf8(std::filesystem::current_path() / "assets" / "player.png")拼接（注意sf::Texture::loadFromFile()接收const std::string&，需转.toAnsiString()或用 UTF-8 兼容版本） - Linux/macOS 下路径区分大小写，
"Player.PNG"加载"player.png"一定失败；Windows 下虽然不敏感，但别依赖这个
游戏循环卡顿或掉帧？别在 pollEvent() 里做耗时操作
sf::RenderWindow::pollEvent() 本身很快，但很多人习惯在里面处理输入+更新逻辑+渲染，结果一帧干了所有事，帧率崩到 5–10 FPS 还以为是 SFML 性能差。
- 标准游戏循环结构必须分离：while (window.isOpen()) { 处理事件 → 更新游戏状态 → 渲染 }，三步不能混在
pollEvent()的 if 分支里 - 特别注意：
sf::Clock计时要放在循环开头，用clock.restart().asSeconds()获取 delta time；别用sleep_for控制帧率——它会让输入响应延迟，且不同系统精度差异大 - 如果用了
window.setFramerateLimit(60)，它只是粗略限制，不解决逻辑卡顿；真正卡顿时，优先检查是否有std::cout、磁盘读写、未优化的 vector 遍历藏在 update 里
精灵移动抖动或模糊？确保坐标用 float，禁用纹理平滑
明明每帧加 0.5f，角色却一卡一卡走，或者放大后边缘发虚——大概率是坐标被隐式转成 int，或纹理采样开了线性滤波。
立即学习“C++免费学习笔记（深入）”；
-
sf::Sprite::setPosition()接收sf::Vector2f，但如果你传了int或忘了加f后缀（比如写10而非10.0f），某些编译器会触发隐式转换警告甚至截断 - 纹理模糊主因是
sf::Texture::setSmooth(true)默认开启（为了缩放抗锯齿），2D 像素风游戏务必关掉：texture.setSmooth(false) - 窗口缩放时，如果用
window.setView()改变视图，记得同步设置view.setCenter()和view.setSize()，否则坐标映射偏移会导致移动“跳帧”
最麻烦的其实是跨平台音频初始化失败和字体度量不一致，这两个点一旦出问题，调试成本远高于图形——建议早期就单独写个 minimal test.cpp 验证声音播放和中文字符渲染是否正常。
