安装指南
通过 pip 一键安装，无需复杂配置，支持 Python 3.7+。
目录
环境要求
Python
Python 3.7 / 3.8 / 3.9 / 3.10 / 3.11 / 3.12
NumPy
PyViz3D 自动处理依赖
无需编译
纯 Python + WebGL，无需 C++ 编译
可选：Blender
用于高质量渲染导出
pip 安装
推荐在虚拟环境中安装（使用 venv 或 conda）：
使用 pipx 隔离安装最适合长期使用：
pipx install pyviz3d
标准安装
# 安装最新版
pip install pyviz3d
# 或指定版本
pip install pyviz3d==1.0.0
从源码安装（开发版）
# 克隆仓库
git clone https://github.com/francisengelmann/PyViz3D.git
cd PyViz3D
# 安装依赖并链接包
pip install -e .
依赖说明
PyViz3D 自动安装以下依赖：
- numpy — 数值计算，用于点云坐标与颜色数组处理
- open3d (可选) — 用于读取 PCD、PLY 等格式的 3D 文件
- flask — 启动本地 Web 服务器时使用
open3d 在 macOS Apple Silicon 上可能需要从源码编译。如遇安装问题，可跳过：
pip install pyviz3d --no-deps 后手动安装 numpy 和 flask。
Blender 集成（可选）
如需将可视化导出为 Blender 可编辑的 .blend 文件，需要安装 Blender（3.0+）并在系统 PATH 中可用。
# 验证 Blender 集成是否可用
python -c "from pyviz3d.blender_tools import blender_available; print(blender_available())"
Windows
- 从 blender.org 下载安装
- 将 Blender 添加到系统 PATH（通常是
C:\Program Files\Blender Foundation\Blender X.XX） - 重新打开终端验证
macOS / Linux
brew install blender（macOS）或从源码编译 / 下载 AppImage（Linux）- 确保
blender命令在终端中可用
验证安装
python -c "import pyviz3d as viz; print('PyViz3D 版本:', viz.__version__)"
运行一个简单示例：
import pyviz3d as viz
import numpy as np
v = viz.Visualizer()
# 生成 1000 个随机彩色点
points = np.random.rand(1000, 3) * 10
colors = np.random.rand(1000, 3)
v.add_points("cloud", points, colors)
# 浏览器中查看
v.save("output")
卸载
pip uninstall pyviz3d