用于Blender的Verge3D：安装 - Soft8Soft
Description: 本页介绍Blender版Verge3D的安装过程。

# 安装/Blender

- 先决条件
- 下载Verge3D
- 在Windows中安装
- 在macOS中安装
- 在Linux中安装
- 在ChromeOS中安装
  - 安装Linux开发环境
  - 在ChromeOS上安装Blender
  - 安装Verge3D
  - 首次运行
- 故障排除
  - ModuleNotFoundError: No module named 'numpy'

#

## 先决条件

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)，在线寻求帮助。