简介这是一份基于Unity3D制作个人太阳系科普模拟的完整项目资源适合Unity初学者、游戏开发爱好者及天文模拟类课程设计参考。资源围绕场景构建、行星运动、自转动画和摄像机控制等核心模块展开可帮助理解C#脚本驱动天体轨道、物理引擎模拟与UI信息展示的协作方式。压缩包共2522个文件整体约77.65MB包含242个C#脚本、542个meta资源元数据、656个info说明文件以及png/psd贴图、mat材质、shader着色器、asset资源、dll库等类型覆盖从模型材质到脚本逻辑的完整开发链路。项目内附完整的Unity工程文件与目录结构可直接打开查看各场景和脚本实现适合对照学习行星椭圆轨道设定、自转动画、光源阴影调节及交互界面设计等关键知识点。已有419人学习浏览对于希望从零搭建一个可运行的太阳系模拟场景的开发者而言是一份具备较强实操参考价值的范例。1. MyTestSolarSystem.rar 到底是什么一个压缩包背后的三维太阳系工程看到这个名字多数人的第一反应是解压、找 exe、双击看太阳系。实际这么干的人十个里有八个翻车包里根本没有 exe只有源码和资源文件。不是包坏了而是这类三维工程包分发的是原料不是成品。它的本质是一个以太阳系为场景的三维图形工程太阳居中行星按轨道公转、绕轴自转相机可旋转缩放。来源通常是图形学课程设计、某公司的内部 Demo或某开发者练手后的打包。拿到它的人诉求无非三种跑起来、改参数、做成能演示的作品。下面按这三条诉求走先判断技术栈再还原成能跑通的工程最后把天体比例、轨道速度和相机控制调成你想要的样子。三维入门、接手 Demo、准备课程作业的开发者都能找到对应的一步。2. 解压前先看货从压缩包内容识别技术栈与工程结构这一步最容易被跳过也最容易省时间。双击解压再翻目录遇到中文乱码、缺构建入口、装了错依赖都得回来重看。我一般用命令行先看压缩包内容不落地就完成初步判断。2.1 用命令行先看压缩包内容不落地就完成技术栈初判我习惯用 7z 而不是双击解压工具因为 7z 在三个平台上行为一致还能直接列出文件清单。7z l MyTestSolarSystem.rarl是 list只列出内容不解压。输出里有文件全路径、大小、目录层级。第一眼看三件事第一层是一个独立文件夹还是散文件有没有 README、CMakeLists.txt、.sln、package.json 这类构建入口有没有 bin、build、Release 这种带 exe 的目录。如果包里有 exe 且旁边有配套 dll那它是绿色版解压后可以直接运行如果只有源码和资源就得走完整还原流程。环境里没有 7z 时Linux 可以用unrar l MyTestSolarSystem.rar效果一样。Windows 下 7-Zip 的命令行程序叫 7z.exe记得把安装目录加进 PATH。光看输出还不够后缀分布能直接告诉你技术栈。我习惯写个小脚本统计import rarfile from collections import Counter rar_path MyTestSolarSystem.rar with rarfile.RarFile(rar_path) as rf: names rf.namelist() ext_counter Counter() for name in names: ext name.rsplit(., 1)[-1].lower() if . in name else (noext) ext_counter[ext] 1 for ext, count in ext_counter.most_common(15): print(f{ext:12} {count}) print(文件总数:, len(names))这段脚本用 rarfile 库读压缩包不落地把所有文件后缀统计出来。rarfile 底层依赖 unrar 可执行文件Linux 上要先装 unrarWindows 上要把 UnRAR.dll 放到可访问路径否则会报找不到工具。统计结果很诚实.cpp/.h 居多就是 C 工程.py 居多就是 Python.html/.js 多于其他就是网页版。后缀分布比任何说明文档都可靠。后缀判断可以对照下面这张速查表后缀特征技术栈构建入口.cpp/.h/.hpp CMakeLists.txtC 或 OpenGLcmake.sln / .vcxprojCWindows 系Visual Studio 生成.py requirements.txtPythonpip python main.py.html/.js/.ts package.json前端 3DThree.js 常见npm run dev.cs 目录结构含 UnityUnity 工程Unity Editor出现多个入口时以构建入口为准比如既有 CMakeLists.txt 又有 Makefile优先用 CMake它更不依赖特定机器。项目名里带 Test大概率是练习工程构建入口只会有一个。看 README 也不用解压整个包7z 支持提取单个文件到标准输出7z e -so MyTestSolarSystem.rar README.mde是 extract-so表示写到标准输出直接打印内容不解压其他文件。很多打包者会把运行说明、依赖版本写进 README这一段信息比猜后缀准确得多。2.2 从目录结构与关键库定位渲染框架如果后缀判断是 C下一步要看具体用了哪个窗口库和数学库。在 7z 的清单里搜 glfw、glut、freeglut、glew、glm、assimp 这些关键词或者把 CMakeLists.txt 单独提取出来看find_package和target_link_libraries。窗口库决定依赖怎么装数学库决定代码写法。用 GLFW 的工程依赖libglfw3-dev用 GLUT 的工程依赖freeglut3-dev装错一个编译报错能让人查半天。确认框架后三维太阳系工程基本都是三层结构数据层行星参数表可能是头文件里的结构体数组也可能是 OrbitData.json逻辑层每帧更新的公转角度、自转角度通常有一个 SolarSystem 或 Scene 类渲染层网格、shader、相机、光照代码里会出现 glDrawArrays、glDrawElements或对应框架的绘制调用。拿到包后在清单里找这几个类名能快速定位 main 函数和场景类后面改参数就不用通读全部代码。比如清单里出现scene.cpp、planet.h、shader.h那核心逻辑基本就集中在scene.cpp里。先看结构再动手比解压完从头读代码省一半时间。如果包里只有资源文件textures、meshes和一个说明文档没有源码那它只是一个素材包不是工程包后面所有构建步骤都不适用。这种包的价值在于贴图和模型可以复用到你自己的工程里。2.3 资源与配置文件数据驱动还是硬编码这个判断直接决定后面改参数的工作量。硬编码的工程把天体数据直接写在代码里比如Planet planets[] {{Earth, 20.0f, 365.25f}}改半径和周期要重新编译数据驱动的工程会读 config.json 或 orbital_data.txt改完文件重启就能看到效果。判断方法有两个信号清单里有没有 json/txt/csv 数据文件代码里有没有 fopen、ifstream、loadJSON 这类调用。我见过一个打包者把参数写在头文件里却留了一个空的 config.json说明他本来想做配置化做了一半。这种半成品最花时间你得先确认代码到底读不读文件否则改了 JSON 发现没反应还以为是自己改错格式。数据驱动的优点是演示现场改参数不用编译价格低硬编码的优点是单文件好分发不用考虑资源路径。教学 Demo 和课程设计普遍硬编码工程化 Demo 普遍配置化。如果你打算把它改造成拿得出手的作品配置化是值得做的一步最后一章我会专门讲怎么改。3. 把 .rar 还原成能跑的太阳系环境还原与最小启动命令识别完技术栈进入还原阶段。这一章以最常见的 C/OpenGL 工程为主线Python 和前端工程会给出对应命令。目标是跑出一个能交互的窗口。3.1 解压命令与路径规范第一道门槛解压这一步本身就有坑。我的固定命令是7z x MyTestSolarSystem.rar -od:/workspace/mytest_solar -yx是解压并保留目录结构-o指定输出目录-y跳过覆盖确认。输出目录这一点值得多说我用的是全英文小写加下划线mytest_solar。注意输出路径不要带中文和空格。三维工程的资源加载对路径很敏感中文路径是后面各种黑屏和加载失败的常见来源C 的文件流在 Windows 和 Linux 对本地编码的处理不一致空格则会打断脚本参数传递。Windows 上打的包在 Linux 下解压中文文件名会乱码因为 rar 对非 ASCII 文件名没有标准的 UTF-8 标记unrar 按 CP437 解码然后显示成乱码。补救预览可以用下面这段import rarfile rarfile.UNRAR_TOOL /usr/bin/unrar # 按实际路径指定 with rarfile.RarFile(MyTestSolarSystem.rar) as rf: for info in rf.infolist(): try: name info.filename.encode(cp437).decode(gbk) except Exception: name info.filename print(name)这段代码只做文件名预览真正解压后目录里的名字还是乱的。遇到这种包最省事的做法是回到 Windows 下用 7-Zip 重新压一次或者干脆改用 zip 格式分发。如果包里有中文名资源文件宁可早点发现别等编译通过、纹理加载失败才回头找原因。3.2 按技术栈选构建方式CMake 与依赖安装构建入口决定一切。拿到包以后按入口匹配命令构建入口构建命令适用平台CMakeLists.txtcmake -B build cmake --build build全平台.sln用 Visual Studio 打开直接生成WindowsMakefilemakeUnix 系package.jsonnpm install npm run dev全平台requirements.txtpip install -r requirements.txt全平台下面以最常见的情况为例CMakeLists.txt C/OpenGL。这类太阳系 Demo 基本依赖三件套GLFW 提供窗口和 OpenGL 上下文GLEW 加载 OpenGL 扩展GLM 提供矩阵和向量运算。安装命令# Debian/Ubuntu 系 sudo apt install build-essential cmake libglfw3-dev libglew-dev libglm-dev # macOS brew install cmake glfw glew glm每个库都是独立作用GLFW 负责创建窗口和接收鼠标键盘输入GLEW 让旧驱动也能加载新 OpenGL 函数GLM 的glm::vec3和glm::mat4是 C 写三维场景的默认选择。Windows 上常见做法是用 vcpkg 这类 C 包管理器安装同名包装完在 CMake 配置时把工具链路径指过去。注意先看代码 include 了什么再装对应的库。代码里是#include GL/glut.h就装 freeglut装了三件套也编不过。装错库比不装更浪费时间因为报错信息容易误导人去改代码。3.3 最小启动命令从解压到看见第一个窗口依赖装齐后启动命令就是四行cd mytest_solar cmake -B build -DCMAKE_BUILD_TYPERelease cmake --build build -j4 ./build/MyTestSolarSystemcd进入工程目录cmake -B build指定构建目录让源码目录保持干净Release开启优化太阳系这种纯绘制场景Release 和 Debug 的帧率能差一倍--build加-j4并行编译四核机器能明显提速最后运行生成的可执行文件。可执行文件名以实际工程为准多数情况下project命令写的名字就是它。失败时看三个位置cmake报Could NOT find GLFW说明依赖没装或 CMake 找不到库路径检查CMAKE_PREFIX_PATH编译报错看第一个 error最常见是缺头文件或 C 标准不对在 CMakeLists.txt 里加set(CMAKE_CXX_STANDARD 17)能解决大部分问题运行即闪退大概率是动态库找不到Windows 上把 glfw3.dll 放到 exe 同级目录Linux 上执行ldconfig刷新库缓存。Python 工程的最小命令是另一套python -m venv .venv source .venv/bin/activate pip install -r requirements.txt python main.pyvenv 是必须的直接往系统环境装依赖换个项目就会冲突。如果打包者没提供 requirements.txt看代码开头 import 了哪些库手动补一个。Python 三维太阳系常见的依赖是 vpython、pygame、numpyimport 语句会直接告诉你。3.4 首次运行验证怎么算跑通了跑通不是窗口没闪退而是五个检查项都正常检查项正常表现异常信号窗口出现并有标题黑屏即闪退画面太阳、行星、轨道可见全黑或全白交互鼠标旋转缩放流畅卡顿或视角乱跳日志无 error纹理加载失败、上下文创建失败帧率30 FPS 以上个位数帧率黑屏是出现频率最高的异常按这个顺序排查能定位 80% 的问题先看 GLFW 窗口有没有创建成功再看 shader 编译日志有没有 error最后检查纹理路径有没有拼错。控制台输出是这里最好的帮手很多程序只在失败时打一行字跑通时反而什么都不打。如果画面有了但帧率是个位数先看是不是 Debug 模式再看是不是每帧重新编译 shader最后看是不是用了 64x64 的高细分球体。教学 Demo 最常见的性能问题就是球体细分过高这一项放到下一章展开讲。4. 太阳系模拟的核心参数天体比例、轨道速度与相机控制怎么调跑通只是第一步真正花时间的是把参数调成看着像太阳系。天体比例是最玄学的地方直接照抄真实数据反而会失败关键在于压缩方式怎么选。4.1 天体数据表真实太阳系数据为什么不能直接搬直接按真实公里数画会彻底失败太阳半径约 69.6 万公里水星轨道半长轴约 5790 万公里海王星轨道约 45 亿公里。如果按真实比例渲染太阳只占几十个像素水星直接看不见海王星在屏幕外。所以所有太阳系 Demo 都要做两级压缩距离按 sqrt 或对数缩放半径单独给压缩系数。我的习惯是轨道距离用 sqrt 缩放保留内外行星的相对顺序同时压缩动态范围半径用世界单位直接给保证每颗行星至少几个像素可见。行星半径不要跟着距离缩放走否则内行星全是噪点。下面是一份可以照着用的轨道数据 JSON截取了前四颗行星{ timeScale: 86400, sun: { radius: 5.0, color: [1.0, 0.8, 0.2] }, planets: [ { name: Mercury, semiMajorAxis: 10.0, radius: 0.4, periodDays: 87.97, color: [0.7, 0.7, 0.7] }, { name: Venus, semiMajorAxis: 15.0, radius: 0.8, periodDays: 224.7, color: [0.9, 0.8, 0.5] }, { name: Earth, semiMajorAxis: 20.0, radius: 0.85, periodDays: 365.25, color: [0.3, 0.5, 0.9] } ] }参数说明semiMajorAxis是缩放后的轨道半径单位是场景世界单位和真实公里没有换算关系periodDays用真实天数公转周期保持真实比例水星跑得快、地球跑得慢一眼能看出内外行星的速度差timeScale表示每秒模拟多少秒真实时间86400 就是 1 秒对应 1 天。如果你想加上木星、土星照这个格式往后加就行。外行星轨道半径在 sqrt 缩放后会挤在一起可以给外行星额外乘 1.5 到 2 的系数拉开距离视觉效果比物理真实更重要。这个度没有标准答案我的经验是调整完后最内和最外行星的轨道半径比控制在 20:1 左右屏幕上看最舒服。4.2 公转自转的数值实现角度增量与时间缩放公转的核心是一个角度随时间累加。给出最小实现#include cmath struct Planet { float semiMajorAxis; // 缩放后的轨道半径 float radius; // 缩放后的行星半径 float periodDays; // 真实公转周期单位天 float angle; // 当前轨道角度 float rotation; // 当前自转角度 }; void UpdatePlanet(Planet p, float dt, float timeScale) { double periodSeconds p.periodDays * 86400.0; double angularSpeed 2.0 * M_PI / periodSeconds; p.angle angularSpeed * dt * timeScale; p.angle fmod(p.angle, 2.0 * M_PI); // 自转看成周期 1 天的旋转只做演示 p.rotation fmod(p.rotation (2.0 * M_PI / 86400.0) * dt * timeScale, 2.0 * M_PI); } void GetPlanetPosition(const Planet p, float outPos[3]) { outPos[0] std::cos(p.angle) * p.semiMajorAxis; outPos[1] 0.0f; outPos[2] std::sin(p.angle) * p.semiMajorAxis; }逻辑说明角速度等于 2π 除以周期乘dt再乘timeScale得到这一帧的角位移fmod把角度约束在一个周期内防止 float 长时间累加后精度丢失。这里用圆轨道做演示真实行星是椭圆轨道但圆轨道能稳定跑不会出现近点进动问题。参数说明dt必须是真实帧间隔秒不是帧计数。timeScale是全局时间倍率1.0 就是实时86400 是 1 秒 1 天想快进到 1 秒 1 个月就乘 30。注意timeScale太大的时候一帧的角度增量会超过 90 度画面看起来像在跳变一般不要超过 86400 乘 30。GetPlanetPosition用的是 cos/sin 组合行星永远在黄道面上没有轨道倾角这是简化但足够做演示。4.3 相机控制跟随、缩放与旋转的优先级太阳系 Demo 的相机一般做两种轨道相机围绕太阳跟随相机锁定行星。轨道相机的核心是三个参数的边界管理#include algorithm float orbitRadius 50.0f; // 相机到太阳距离 float yaw 0.0f; // 水平旋转角 float pitch 0.6f; // 俯仰角 void HandleCameraInput(float scrollOffset, float mouseDX, float mouseDY) { orbitRadius * 1.0f - scrollOffset * 0.1f; orbitRadius std::clamp(orbitRadius, 5.0f, 300.0f); // 缩放边界 yaw mouseDX * 0.005f; pitch mouseDY * 0.005f; pitch std::clamp(pitch, 0.05f, 1.5f); // 俯仰边界 } void GetCameraPosition(float sunPos[3], float outPos[3]) { outPos[0] sunPos[0] orbitRadius * std::cos(pitch) * std::cos(yaw); outPos[1] sunPos[1] orbitRadius * std::sin(pitch); outPos[2] sunPos[2] orbitRadius * std::cos(pitch) * std::sin(yaw); }说明orbitRadius不 clamp滚轮多滚几下就穿进太阳内部画面全白pitch不 clamp会翻到黄道面下方把整个镜头颠倒。这两个边界是相机手感的关键也是最常漏写的地方。std::clamp需要 C17CMakeLists.txt 里加set(CMAKE_CXX_STANDARD 17)。跟随相机的切换不要硬切位置用插值过渡。常见做法是每帧向目标位置靠拢一个系数系数越大跟得越紧。一次点击切换行星时镜头瞬移会让观看者完全丢失方向感插值过渡是演示体感的分水岭。4.4 渲染表现轨道线、星空背景与太阳光晕基础跑通之后让画面像样的三个点轨道线、星空背景、太阳光晕。轨道线每颗行星预计算 256 个点用GL_LINE_LOOP画一圈。轨道是静态的只在初始化时算一次不要每帧重算。星空背景用一个几千点的粒子数组方向随机分布在单位球面上shader 里按视角旋转。比加载一张 cubemap 贴图省事效果也够。太阳光晕一个 billboard 四边形加半透明贴图开启混合模式模拟光晕。性能边界只有一个原则行星球体细分用 32x16 足够不要上 64x64。8 颗行星用高细分就是几十万顶点教学 Demo 的帧率会很难看。想要细节只给地球单独加细分即可。5. 避坑解压、编译到运行时最常见的五个坑这一章按发生频率排序前四个我都踩过不止一次。每条都按现象、原因、解决三个步骤写配合上一章的代码一起看。5.1 rar 只打包了部分工程解压后找不到构建入口现象解压完只有 src 目录和几个 .cpp没有 CMakeLists.txt也没有 .sln找不到任何构建入口。原因打包者只把源码目录拖进了 rar构建文件留在他自己机器上或者是打包工具默认忽略了隐藏文件和根目录文件。这类包往往出现在先在别人机器上跑通了临时打包发给同事的场景。解决先翻 README 和源码注释确认依赖库如果没有自己补一个最小 CMakeLists.txtcmake_minimum_required(VERSION 3.16) project(MyTestSolarSystem LANGUAGES CXX) find_package(OpenGL REQUIRED) find_package(glfw3 REQUIRED) add_executable(MyTestSolarSystem src/main.cpp src/scene.cpp) target_link_libraries(MyTestSolarSystem PRIVATE glfw OpenGL::GL)这段 CMake 是应急的后悔药能解决一半缺构建入口的情况但前提是代码里确实用的是 glfw。如果代码 include 的是 glut改成find_package(GLUT REQUIRED)并链接GLUT::GLUT。自己补构建入口的前提是代码完整如果连 main 函数都没有别补了直接找打包者要全量包。5.2 中文路径导致编译与资源加载失败现象编译顺利通过运行后行星全黑控制台报failed to load texture或file not found但目标路径明明存在。原因纹理路径里带了中文目录或者代码写死了绝对路径。C 的文件流对本地编码的处理在 Windows 和 Linux 上不一致中文路径就是时好时坏的状态换台机器立刻翻车。解决把资源路径改成相对于可执行文件#include filesystem int main(int argc, char* argv[]) { auto exeDir std::filesystem::path(argv[0]).parent_path(); auto texPath exeDir / textures / sun.jpg; // 用 texPath 加载纹理不要写死 D:/我的项目/textures/sun.jpg }这套写法让资源跟随 exe 走拷到任何目录都能跑。很多 Demo 在 Visual Studio 里用工作目录跑通换到命令行就黑屏就是这个原因。配合 3.1 的路径规范解压目录用全英文这个坑基本可以杜绝。5.3 OpenGL 上下文创建失败显卡与 API 版本不匹配现象窗口出现但全黑或直接闪退控制台报GLFW: 无法创建 OpenGL 上下文、WGL: 驱动不支持指定版本。原因代码请求了高版本 OpenGL 核心上下文但当前机器是虚拟机、老集成显卡或者双显卡机器跑到了核显上驱动只支持到 3.3。解决把请求版本降到 3.3glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);降级后要注意 shader 版本声明改成#version 330 core并确认代码没有用到曲面细分、计算着色器这类 4.x 特性。太阳系这种场景用 3.3 完全够硬件曲面细分对教学 Demo 没有实际价值反而增加兼容性负担。5.4 动态库版本冲突跑起来崩在启动阶段现象编译链接全通过一运行就崩Windows 上报0xc000007b或者断言失败在glfwInit、glfwCreateWindow。原因exe 同级目录里混着多套 glfw3.dll或者从别的项目拷了一个不配套的旧 dll。Windows 按目录顺序加载 dll一旦加载到错误版本OpenGL 函数指针不对启动阶段就崩。解决统一 dll 版本。把依赖里一套完整的 glfw3.dll、glew32.dll 放到 exe 目录其他的删干净Linux 上用ldd查看可执行文件的动态依赖确认LD_LIBRARY_PATH里没有混着多个版本的 libglfw.so。这种问题靠改代码无效只能清理环境属于典型的编译通过但跑不起来。5.5 时间步长算错行星抖动与轨道漂移现象行星原地高频抖动或者跑几百圈后轨道半径明显变大甚至飞出去。原因三个来源叠加——把帧计数当时间用float 角度长时间累加丢精度显式欧拉积分在大步长下误差累积。帧率越高抖得越明显这是最阴的坑。解决固定时间步长加角度归一化double lastTime glfwGetTime(); double accumulator 0.0; const double fixedStep 1.0 / 60.0; while (!glfwWindowShouldClose(window)) { double now glfwGetTime(); double frameTime now - lastTime; lastTime now; accumulator frameTime; while (accumulator fixedStep) { UpdatePhysics(fixedStep, timeScale); // 固定步长更新 accumulator - fixedStep; } Render(); // 渲染用最近一次物理结果 }说明把物理更新和渲染解耦显示器 60Hz 和 144Hz 跑出来的天体速度一致也不会因为一帧卡顿产生大步长误差。配合 4.2 的fmod归一化轨道长期运行不会漂移。这套写法多花几行但是给后续所有功能打底值得现在改掉。6. 进阶把测试太阳系改造成拿得出手的演示作品跑通和调参之后如果你要演示或交作业还差三个小改造。这三个改动都不动核心逻辑但能把体验拉开一个档次。6.1 演示三件套快捷键、标签、视角动画演示现场最怕的是只能看不能操作。加一组快捷键成本很低收益最直接按键功能实现要点Space暂停/继续全局 timeScale 置 0 再恢复R复位视角重置 orbitRadius、yaw、pitchF跟随选定行星相机目标从太阳切到行星 / -变速timeScale 按倍数增减暂停和变速直接改第 4 章的 timeScale 就能做不用动物理逻辑。跟随相机的切换要加过渡避免镜头瞬移。插值系数用指数形式float t 1.0f - std::exp(-dt * 3.0f); cameraPos cameraPos * (1.0f - t) targetPos * t;exp方式的插值系数与帧率无关比固定lerp 0.05更稳跟得紧又不会抖。6.2 把参数改成配置文件现场调参不用重编译演示时被问参数在哪改是最尴尬的。把 4.1 的 JSON 作为运行时输入替换硬编码数组启动时读取文件现场改时间倍率、行星颜色重启就生效不用重新编译。顺手加一个命令行参数指定配置文件路径默认值指向工程目录这些改动加起来不超过一百行。我早期接手这种包时总想赶紧跑起来结果在环境上砸了一下午。后来养成习惯先看货、再动环境、最后动参数顺序反了就得吃后悔药。希望帮到你。本文还有配套的精品资源点击获取
