# USD 教程入门:正确配置环境变量 PYTHONPATH 与 PATH
## 摘要
本文基于 Universal Scene Description (USD) 22.08 官方文档,详细解析了运行其内置 Python 教程所需的环境变量配置步骤。重点说明如何设置 `PYTHONPATH` 和 `PATH` 以确保 Python 绑定及工具链正常工作。
## 为什么需要配置环境变量?
USD 提供了一套丰富的教程资源,这些教程主要依赖 USD 内置的 Python 绑定(Python bindings)。此外,部分 USD 工具集中的程序之间存在相互依赖关系。为了确保能够顺利运行所有教程代码并调用相关工具,必须在系统环境中进行特定的变量配置。
## 核心环境变量设置
根据官方文档指引,需要重点配置以下两个环境变量:
### 1. PYTHONPATH
* **作用**:指定 Python 模块搜索路径。这确保了 Python 解释器能够找到 USD 的 Python 绑定库文件。
* **推荐值**:`USD_INSTALL_ROOT/lib/python`
* 请将 `USD_INSTALL_ROOT` 替换为您实际安装 USD 软件的基础目录路径。
### 2. PATH
* **作用**:指定程序搜索路径。这确保了系统命令行能够直接调用 USD 提供的各种工具(如 usdview, usdcat 等)。
* **推荐值**:`USD_INSTALL_ROOT/bin`
* 同样,请将 `USD_INSTALL_ROOT` 替换为实际的安装根目录。
## 配置后的验证
完成上述设置后,您可以尝试在终端或命令行中运行简单的 Python 脚本导入 USD 模块,或直接调用工具集中的命令(如输入 `usdview`),以确认环境变量已生效且工具链运行正常。官方文档建议参考“高级构建配置”部分获取更详细的进阶信息。
## 结语
正确配置环境变量是学习 USD 的第一步。通过设置上述路径,您可以无障碍地进入 Hello World、图层引用及属性编辑等后续教程环节,顺利开展三维场景描述的学习与实践。