安装/Blender
先决条件
Verge3D可以基于Blender 4.2-5.0运行，请预先安装对应的版本。我们推荐使用最新兼容版本以获得最多功能和更长的可用期。Blender是一款开源软件，可从 官方网站 免费下载。
下载Verge3D
下载适用于您的操作系统的 Verge3D for Blender （Windows的 .exe 安装程序，macOS的 .pkg 安装程序，或Linux/ChromeOS的 .xz 压缩包）。
在Windows中安装
双击 .exe 文件以运行安装程序。
点击链接阅读最新版本的 Verge3D 许可协议。
选择您要安装的组件。
选择一个有足够读写权限的安装目录（建议使用默认路径）。
请等待安装程序执行完成。
当安装完成时，屏幕显示如下。
请点击完成并打开Blender。如果Blender正在运行，请先关闭然后再次打开。
您也可以通过桌面图标或开始菜单中的快捷方式来打开应用管理器，这种启动方式无需启动Blender。
在macOS中安装
双击 .pkg 文件以运行安装程序。
点击链接阅读最新版本的 Verge3D 许可协议。
然后点击同意以接受许可协议。
您可以快速跳过下一步，因为Verge3D在macOS上始终安装到用户主目录中。
请等待安装程序完成文件复制。
安装完成后，您将看到以下屏幕。
点击关闭并打开Blender。如果Blender正在运行，请先关闭然后再次打开。
您也可以通过Launchpad中的图标来打开应用管理器，无需启动Blender：
或者您可以将该启动器直接拖放到macOS Dock上以便快速访问：
在Linux中安装
将 .xz 压缩包解压到您选择的目录中。请确保您有足够的权限在此文件夹中进行读/写操作。不建议在系统目录中安装。在下文中，我们将解压后的目录称为 Verge3D安装文件夹。
在Blender中，通过选择编辑菜单中的相应选项来打开偏好设置窗口。
在获取扩展选项卡上，点击仓库菜单。在打开的对话框中，点击添加（+）按钮来添加一个新仓库。
选择添加本地仓库。
在接下来的对话框中，将"Soft8Soft"指定为仓库名称，激活自定义目录，然后提供解压后的Verge3D压缩包中"addons"文件夹的路径。点击创建按钮。
请注意此步骤。指定的文件夹应以"addons"结尾，而不是"addons/verge3d"。
从扩展菜单（v）中点击查看详情以打开扩展设置（或者您也可以在插件选项卡中找到Verge3D）。
启用Verge3D扩展，然后关闭Blender偏好设置窗口。
安装完成！
在ChromeOS中安装
要在ChromeOS上运行Verge3D，您需要通过Linux开发环境安装Blender。
安装Linux开发环境
在ChromeOS设置中找到开发者选项卡，然后点击Linux开发环境旁边的开启：
在下一个屏幕上点击下一步：
然后为Linux环境选择一个用户名和磁盘大小。默认的10 GB在大多数情况下足够了。只有当您要开发非常大的应用时，才可能需要选择更大的值。
安装过程开始：
安装完成后，继续下一步。
Debian 12 (Bookworm) 附带的 Blender 3.4 已不再被Verge3D支持。请更新Linux开发环境到Debian 13 (Trixie)后再继续安装。
在ChromeOS上安装Blender
要在ChromeOS上安装Blender，请启动终端：
执行以下命令以更新仓库元数据：
sudo apt update
然后安装Blender（及其所有依赖项）：
sudo apt install blender
Verge3D插件还需要 numpy 库（由导出器使用）和 zenity 工具（使应用管理器设置对话框正常工作）。以类似方式安装两者：
sudo apt install python3-numpy zenity
Blender安装完成！您可以像其他ChromeOS应用一样使用快捷方式运行它：
安装Verge3D
打开Verge3D的 .xz 压缩包并将其解压到您选择的文件夹中。为了简化在Blender设置中指定Verge3D文件夹，建议将 verge3d_blender 直接解压到Linux文件中：
在Blender中，通过选择编辑菜单中的相应选项来打开偏好设置窗口，然后转到文件路径：
在文件路径选项卡上，找到脚本字段，并将其路径指向Verge3D安装的文件夹。关闭偏好设置窗口并 重启Blender。
再次打开偏好设置窗口并转到插件选项卡。找到并启用Verge3D插件，然后关闭窗口。
点击应用管理器按钮并继续下一步。
首次运行
首次运行时，会显示一个启动画面，提示您设置Verge3D应用程序文件夹的路径。您可以保持默认值。在这种情况下，Verge3D应用程序将在Linux环境中创建：
设置好应用程序文件夹后，点击应用。安装完成！
或者，如果您希望将应用程序保存在ChromeOS中，请执行以下操作。在ChromeOS的文件中创建一个文件夹，右键点击它并在菜单中选择与Linux共享。以类似方式，您还可以提供位于Google Drive或Windows共享上的文件夹。
共享文件夹后，它将在Linux中通过 /mnt/chromeos/... 路径访问：
故障排除
ModuleNotFoundError: No module named 'numpy'
在Linux/ChromeOS上，您可能会在激活Verge3D时看到以下错误，提示没有名为 numpy 的模块：
如果看到此错误，请使用系统包管理器安装 numpy，例如在Ubuntu上：
sudo apt install python3-numpy
然后再次尝试激活Verge3D插件。
向前一步
推荐您熟悉一下 入门指南并开始探索！
遇到问题？
欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。