Arch Linux Plasma Wayland环境下GLFW创建的Vulkan窗口仅显示Dock图标无法正常显示的问题求助及GLFW教程推荐

嘿，我之前在Wayland环境下折腾Vulkan+GLFW时也遇到过一模一样的问题！你的代码逻辑其实没问题，但漏掉了Vulkan窗口表面（Surface）的创建——这是Wayland compositor（也就是Plasma的窗口管理器）能正确渲染窗口内容的关键环节。

问题原因分析 #

你设置了GLFW_CLIENT_API, GLFW_NO_API，这告诉GLFW：“我不用你自带的OpenGL/ES上下文，我要自己用Vulkan”。但这也意味着GLFW不会帮你自动创建Wayland需要的窗口表面，它只会帮你注册一个窗口的元数据（所以Dock能看到图标，hover能看到窗口占位），但没有任何实际的渲染表面让Wayland把内容画到屏幕上。另外，你的代码里也没有初始化任何Vulkan的核心组件（比如Instance），连最基础的渲染上下文都没有，自然看不到窗口内容。

修复步骤及代码修改 #

你需要补充以下几个关键步骤：

1. 查询并启用Wayland环境下Vulkan所需的扩展（VK_KHR_wayland_surface）
2. 创建Vulkan Instance并包含上述扩展
3. 用GLFW提供的函数创建Vulkan窗口表面

下面是修改后的完整代码示例：

#include <vulkan/vulkan.h>
#include <GLFW/glfw3.h>
#define GLM_FORCE_RADIANS
#define GLM_FORCE_DEPTH_ZERO_TO_ONE
#include <glm/glm.hpp>
#include <iostream>
#include <vector>

int main() {
    glfwInit();
    glfwWindowHint(GLFW_CLIENT_API, GLFW_NO_API);
    // Wayland下需要明确指定窗口类型，避免兼容问题
    glfwWindowHint(GLFW_PLATFORM, GLFW_PLATFORM_WAYLAND);
    
    GLFWwindow* window = glfwCreateWindow(800, 600, "Vulkan window", nullptr, nullptr);
    if (!window) {
        std::cerr << "Failed to create GLFW window!" << std::endl;
        glfwTerminate();
        return -1;
    }

    // 1. 查询Vulkan所需的Wayland扩展
    uint32_t extensionCount = 0;
    vkEnumerateInstanceExtensionProperties(nullptr, &extensionCount, nullptr);
    std::vector<VkExtensionProperties> extensions(extensionCount);
    vkEnumerateInstanceExtensionProperties(nullptr, &extensionCount, extensions.data());

    std::cout << extensionCount << " extensions supported\n";
    // 检查是否有Wayland表面扩展
    bool hasWaylandSurface = false;
    for (const auto& ext : extensions) {
        if (strcmp(ext.extensionName, VK_KHR_WAYLAND_SURFACE_EXTENSION_NAME) == 0) {
            hasWaylandSurface = true;
            std::cout << "Found required extension: " << ext.extensionName << std::endl;
            break;
        }
    }
    if (!hasWaylandSurface) {
        std::cerr << "VK_KHR_wayland_surface extension not found!" << std::endl;
        glfwDestroyWindow(window);
        glfwTerminate();
        return -1;
    }

    // 2. 创建Vulkan Instance，包含所需扩展
    VkInstanceCreateInfo createInfo{};
    createInfo.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
    const char* requiredExtensions[] = {VK_KHR_WAYLAND_SURFACE_EXTENSION_NAME, GLFW_VULKAN_EXTENSIONS};
    createInfo.enabledExtensionCount = sizeof(requiredExtensions) / sizeof(requiredExtensions[0]);
    createInfo.ppEnabledExtensionNames = requiredExtensions;

    VkInstance instance;
    VkResult result = vkCreateInstance(&createInfo, nullptr, &instance);
    if (result != VK_SUCCESS) {
        std::cerr << "Failed to create Vulkan Instance!" << std::endl;
        glfwDestroyWindow(window);
        glfwTerminate();
        return -1;
    }

    // 3. 创建Vulkan窗口表面
    VkSurfaceKHR surface;
    result = glfwCreateWindowSurface(instance, window, nullptr, &surface);
    if (result != VK_SUCCESS) {
        std::cerr << "Failed to create Vulkan window surface!" << std::endl;
        vkDestroyInstance(instance, nullptr);
        glfwDestroyWindow(window);
        glfwTerminate();
        return -1;
    }

    // 这里可以继续添加Vulkan设备选择、队列族查询等后续步骤
    glm::mat4 matrix;
    glm::vec4 vec;
    auto test = matrix * vec;

    while(!glfwWindowShouldClose(window)) {
        glfwPollEvents();
    }

    // 清理资源
    vkDestroySurfaceKHR(instance, surface, nullptr);
    vkDestroyInstance(instance, nullptr);
    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

GLFW学习建议（无外链纯干货） #

我理解你现在对GLFW的作用有点模糊，其实GLFW就是个跨平台的“窗口管家”——它帮你搞定不同系统（Wayland/X11/Windows/macOS）里创建窗口、处理输入、管理显示设备这些繁琐的底层操作，让你不用写一堆系统特定的代码，专注于图形渲染本身。

学习顺序推荐：

1. 先搞懂GLFW的基础生命周期：

   • 从最简单的“创建空窗口+事件循环”开始，不用结合任何图形API，先理解glfwInit/glfwCreateWindow/glfwPollEvents/glfwTerminate这些函数的作用，以及窗口大小变化、关闭事件的处理。
   • 尝试添加键盘、鼠标输入监听，比如按下ESC关闭窗口，移动鼠标打印坐标，熟悉GLFW的回调机制。

2. 结合Vulkan逐步深入：

   • 先学会用GLFW查询Vulkan所需的扩展（像你代码里的vkEnumerateInstanceExtensionProperties），理解为什么不同平台需要不同的扩展。
   • 然后学习创建Vulkan Instance、窗口表面，再到选择物理设备、创建逻辑设备，逐步构建Vulkan的渲染上下文。
   • 最后学习交换链（Swapchain）的创建，这是Vulkan把图像输出到窗口的关键环节，完成这一步你就能看到窗口里的内容了。

3. 重点理解GLFW与图形API的交互：

   • 比如GLFW_CLIENT_API这个hint的作用：指定你要用Vulkan还是OpenGL，不同的选项对应不同的后续操作。
   • GLFW提供的glfwGetRequiredInstanceExtensions（Vulkan）、glfwCreateContext（OpenGL）这些函数，是连接GLFW和图形API的桥梁。

学习要点提示：

• 不要跳过基础直接学Vulkan结合GLFW，先把GLFW的窗口和输入逻辑摸透，后面结合图形API会轻松很多。
• 多打印日志，比如扩展查询结果、Vulkan操作的返回值，这样出问题时能快速定位原因。
• 针对Wayland环境，要注意GLFW的平台相关hint（比如GLFW_PLATFORM），避免X11兼容模式的问题。

内容来源于stack exchange