# 安装

ZOSPy 可通过[PyPI](https://pypi.org/project/zospy/)和[conda-forge](https://anaconda.org/conda-forge/zospy)获得。

::::{tab-set} :::{tab-item} 通过pip安装 通过pip安装 ZOSPy，请在终端中运行以下命令：

```bash
pip install zospy
```

::: :::{tab-item} 通过conda安装 通过 conda 安装 ZOSPy，请在终端中运行以下命令：

```bash
conda install conda-forge::zospy
```

::: ::::

## 在单独的环境中使用ZOSPy

我们建议在单独的（虚拟）环境中使用ZOSPy，以防止与其他包或旧的 ZOS-API 项目发生冲突。

:::::{tab-set} ::::{tab-item} 使用 conda 要创建一个名为“optics”的新 conda 环境，并安装Python 3.12和ZOSPy，请运行以下命令：

```bash
conda create -n optics -c conda-forge python=3.12 zospy
```

:::: ::::{tab-item} 使用venv要创建一个名为“zospy_venv”的新虚拟环境，并安装ZOSPy，请运行以下命令：

```bash
# Create a new virtual environment
python -m venv zospy_venv

# Activate the virtual environment
.\zospy_venv\Scripts\activate

# Install ZOSPy in the virtual environment
pip install zospy
```

:::{note} 尽管`venv`模块包含在 Python 标准库中，但还有许多更易于使用的环境管理工具，例如[virtualenv](https://virtualenv.pypa.io/en/latest/) 、 [uv](https://docs.astral.sh/uv/) 、 [pipenv](https://pipenv.pypa.io/en/latest/)和[poetry](https://python-poetry.org/) 。我们建议使用其中一种工具来管理您的虚拟环境。 ::: :::: :::::