SceneKit：向相机节点添加平行光无效果问题排查

我之前也踩过这个坑！在Xcode场景编辑器里配置好的灯光，用代码实现时却没效果，大概率是几个容易忽略的细节没做好，咱们一个个排查：

1. 平行光节点没正确添加到场景根节点 #

这是最常见的错误——你可能创建了平行光，但忘了把它的节点加到场景的根节点上！编辑器里的灯光默认都是挂在根节点下的，代码里一定要补上这一步：

let directionalLightNode = SCNNode()
// ... 配置平行光属性 ...
scene.rootNode.addChildNode(directionalLightNode)

别把光节点加到相机节点下面，否则相机移动时灯光会跟着偏移，导致光照方向完全不符合预期。

2. 平行光的朝向（欧拉角）和编辑器不一致 #

SceneKit里平行光的方向由节点的朝向决定（沿着节点的-z轴），编辑器里默认的平行光欧拉角一般是x: -π/2, y: 0, z: 0（也就是从正上方垂直照射）。如果你代码里没设置这个，光的方向可能歪到没照到物体上，看起来就像没加光一样。
直接照搬编辑器里的数值就好，比如：

directionalLightNode.eulerAngles = SCNVector3(-Double.pi / 2, 0, 0)

你可以在Xcode场景编辑器里选中平行光节点，在右侧检查器里查看精确的欧拉角数值，代码里完全对应上。

3. 灯光属性配置和编辑器不匹配 #

确保代码里的灯光类型、颜色透明度和编辑器一致：

• 平行光的type必须设为.directional，别不小心写成了.spot或者.omni
• 颜色透明度要对应：70%白色就是UIColor.white.withAlphaComponent(0.7)，环境光50%白色就是UIColor.white.withAlphaComponent(0.5)

完整的正确代码示例 #

把这些点结合起来，完整的配置代码应该是这样的：

// 配置环境光
let ambientLight = SCNLight()
ambientLight.type = .ambient
ambientLight.color = UIColor.white.withAlphaComponent(0.5)
scene.ambientLight = ambientLight

// 配置平行光
let directionalLight = SCNLight()
directionalLight.type = .directional
directionalLight.color = UIColor.white.withAlphaComponent(0.7)

let directionalLightNode = SCNNode()
directionalLightNode.light = directionalLight
// 对应编辑器默认欧拉角
directionalLightNode.eulerAngles = SCNVector3(-Double.pi / 2, 0, 0)
// 添加到场景根节点
scene.rootNode.addChildNode(directionalLightNode)

按照这个代码配置，应该就能和编辑器里的效果完全一致了！

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