NeRFStudio 安装与测试指南（附个人环境配置）

📍 项目地址：nerfstudio-project/nerfstudio - GitHub
💻 本人环境：

• Python：3.10（最好3.9或3.10）

• PyTorch：2.1.0 + cu118

• IDE：PyCharm

• Conda 环境名称：gsplat

🧩 安装步骤

1. 克隆仓库

git clone https://github.com/nerfstudio-project/nerfstudio.git

cd nerfstudio

2. 升级 pip 并安装 CUDA Toolkit（11.8）

pip install --upgrade pip

conda install -c "nvidia/label/cuda-11.8.0" cuda-toolkit

3. 可选安装 tiny-cuda-nn（失败不影响使用）

pip install ninja git+https://github.com/NVlabs/tiny-cuda-nn/#subdirectory=bindings/torch

⚠️ 若该步骤安装失败，可参考这篇教程：
👉 【三维重建工具】NeRFStudio、3D GaussianSplatting、Colmap安装与使用指南 - 优快云博客】

4. 安装项目依赖

pip install --upgrade pip setuptools 
pip install -e .

5. 降级 NumPy（重要）

NeRFStudio 当前版本不兼容 NumPy 2.x，请降级为 1.x：

pip install "numpy<2"

✅ 测试运行

1. 下载测试数据

ns-download-data nerfstudio --capture-name=poster

2. 启动训练

ns-train nerfacto --data data/nerfstudio/poster

如配置无误，训练应可正常运行！

​

​

🚧 问题与解决记录（持续更新）

后续我会在此处补充运行过程中的常见报错及解决方案，欢迎收藏关注！