为什么我的PyOpenGL程序中深度测试(Depth Testing)功能无法正常工作

核心问题1：GLFW窗口未请求深度缓冲 #

你在调用glfw.create_window创建窗口前，没有显式指定深度缓冲的位数，GLFW默认不会分配深度缓冲，导致即使开启GL_DEPTH_TEST也没有存储深度信息的空间，深度测试自然无法生效。
修改方法：在创建窗口前添加如下配置：

glfw.window_hint(glfw.DEPTH_BITS, 24)

核心问题2：四边形顶点定义错误 #

GL_QUADS渲染模式要求每4个连续顶点定义一个四边形，你当前每个面的代码写了8个顶点（每个顶点重复声明了一次），相当于每个面被错误拆成了2个重叠的四边形，打乱了渲染顺序。
以红色前面为例，原代码写了8次glVertex3f，正确写法只需要保留4个顶点即可：

# 红色面 正确写法
glColor3f(1, 0, 0)
glVertex3f(cube[0][0], cube[0][1], cube[0][2])
glVertex3f(cube[1][0], cube[1][1], cube[1][2])
glVertex3f(cube[2][0], cube[2][1], cube[2][2])
glVertex3f(cube[3][0], cube[3][1], cube[3][2])

所有面都要按照这个规则修改，删除重复的顶点声明。 #

其他可优化问题 #

1. 颜色值范围错误：glColor3f接受的参数范围是0.0~1.0，你传入255会被截断为最大值，导致颜色显示异常，比如红色应该写成glColor3f(1.0, 0.0, 0.0)，灰度值150对应的是150/255 ≈ 0.588，对应修改所有颜色参数即可。
2. 深度测试配置不需要重复执行：glEnable(GL_DEPTH_TEST)和glDepthFunc(GL_LESS)只需要在初始化阶段执行一次，不需要放到渲染循环里反复调用。
3. 冗余代码可删除：你声明了glEnableClientState(GL_VERTEX_ARRAY)但实际使用的是glBegin/glEnd立即渲染模式，没有用到顶点数组，该行代码可以直接删除。

修改完成后深度测试就可以正常工作，立方体的遮挡关系也会正确显示。

内容的提问来源于stack exchange，提问作者Vasek Blanarovic