three.js 场景全黑通常是因为缺少基础光照，仅靠点光源无法照亮默认材质的物体，必须添加环境光才能让模型显现。

three.js 场景全黑通常是因为缺少基础光照，仅靠点光源无法照亮默认材质的物体，必须添加环境光才能让模型显现。

在你的代码中，虽然已创建了 PointLight（点光源），但它只从一个位置向四周发射光线，且 MeshStandardMaterial 是一种基于物理的材质（PBR），默认不接收“无方向”的直接光照信息——它需要至少两种光源协同工作：一种提供明暗过渡（如点光、平行光），另一种提供全局基础亮度（即环境光）。而你当前未添加环境光，导致球体整体处于无光照计算状态，最终渲染为纯黑。

✅ 正确做法是：在场景中添加 AmbientLight，为所有表面提供均匀、无方向的基础照明：

// 添加环境光（必不可少！）
const ambientLight = new THREE.AmbientLight(0x404040); // 柔和灰白光，强度适中
scene.add(ambientLight);

// 保留你的点光源（用于制造明暗对比和立体感）
const pointLight = new THREE.PointLight(0xffffff, 1, 100);
pointLight.position.set(0, 10, 10); // ⚠️ 注意：原代码中写法错误！应为 .position.set(x, y, z)，而非 .position.set = (...)
scene.add(pointLight);

⚠️ 关键修正点：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• light.position.set = (0, 10, 10) 是语法错误，会导致 set 被覆盖为 undefined，实际未设置位置。正确写法是 light.position.set(0, 10, 10)。
• PerspectiveCamera 构造时未传入近远裁剪面（near/far），虽有默认值，但显式声明更健壮：

  const camera = new THREE.PerspectiveCamera(45, 800 / 600, 0.1, 1000);

? 完整修复后渲染逻辑建议（避免只调用一次 render()）：

// 启动动画循环，持续渲染
function animate() {
  requestAnimationFrame(animate);
  renderer.render(scene, camera);
}
animate();

? 小结：Three.js 中 MeshStandardMaterial 等 PBR 材质严格依赖光照系统。没有环境光 → 全黑；没有主光源 → 平面无立体感。务必同时配置 AmbientLight（全局基底） + 至少一个方向性光源（如 PointLight、DirectionalLight），并确保光源位置、材质属性与相机视锥均配置正确。