先让绿色立方体转起来是Three.js入门关键，需用<script type="module">引入Three.module.js，按scene→camera→renderer顺序初始化，用MeshBasicMaterial避免光照问题，动画必须用requestAnimationFrame循环渲染。
直接上手写一个能跑的 Three.js 页面，关键不是“学完再写”，而是先让绿色立方体转起来。只要这一步成功，后续所有概念都有了落点。
用 <script type="module"> 引入 Three.js（别用传统 <script src>）
现代浏览器原生支持 ES 模块，这是目前最干净、无构建工具的入门方式。如果直接用 <script src="https://cdn.jsdelivr.net/npm/three@0.164.0/build/three.min.js">，后续想用 OrbitControls 或其他 examples/jsm 里的模块会报错：找不到 import 路径。
正确做法是：
- HTML 中声明
<script type="module" src="main.js"> -
main.js里用import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.164.0/examples/jsm/core/BufferGeometry.js';这类路径不行 —— 必须统一用官方推荐的 CDN 模块入口：import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.164.0/examples/jsm/Three.module.js'; - 注意：这个
Three.module.js是专为模块环境打包的，不是three.min.js
THREE.Scene、THREE.PerspectiveCamera、THREE.WebGLRenderer 三件套必须按顺序初始化
顺序错或漏掉任意一个，页面就是黑屏或报 Cannot read property 'domElement' of undefined 这类错误。
立即学习“前端免费学习笔记（深入）”；
典型初始化顺序：
- 先
const scene = new THREE.Scene(); - 再
const camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);—— 注意0.1是近裁剪面，设太小（比如0.001）会导致 z-fighting；设太大（比如1）会让靠近相机的物体直接被裁掉 - 然后
const renderer = new THREE.WebGLRenderer({ antialias: true });—— 加{ antialias: true }能让边缘更平滑，不加的话立方体边缘锯齿明显 - 最后别忘了
renderer.setSize(window.innerWidth, window.innerHeight); document.body.appendChild(renderer.domElement);
创建立方体时，THREE.BoxGeometry 和 THREE.MeshBasicMaterial 是最简组合
新手最容易卡在材质和几何体不匹配，比如误用 THREE.MeshStandardMaterial 却没加灯光，结果看到一个全黑方块 —— 它需要光源才能显色。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
起步阶段坚持用基础材质：
const geometry = new THREE.BoxGeometry(1, 1, 1);-
const material = new THREE.MeshBasicMaterial({ color: 0x00ff00 });（绿色） const cube = new THREE.Mesh(geometry, material);scene.add(cube);
注意：MeshBasicMaterial 不受光照影响，适合验证结构；一旦换成 MeshStandardMaterial，就必须加 THREE.AmbientLight 或 THREE.DirectionalLight，否则就是黑的。
动画循环必须用 requestAnimationFrame，别用 setInterval
用 setInterval(() => { cube.rotation.x += 0.01; }, 16) 看似能转，但帧率不稳定，拖动窗口或切 Tab 后容易丢帧、跳变，甚至内存泄漏。
标准写法是：
function animate() {
requestAnimationFrame(animate);
cube.rotation.x += 0.01;
cube.rotation.y += 0.01;
renderer.render(scene, camera);
}
animate();
这里三个动作必须写在同一个函数里：更新状态 → 渲染 → 下一帧。漏掉 renderer.render() 就永远不画；把 render 放在 requestAnimationFrame 外面，就只渲染一次。
真正卡住人的，往往不是数学或图形学，而是模块加载路径不对、材质选错类型、或者动画没触发渲染。跑通第一个旋转立方体后，再逐个替换组件（换相机、加灯光、接控件），比从文档里啃概念快得多。
