> ## Content Index
> Fetch the complete content index at: https://sgpublic.xyz/llms.txt
> Use this file to discover other available public pages before exploring further.

# conda 使用教程
- URL: https://sgpublic.xyz/p/2025/04/6aac9cb1810a48000153360f/
- Published: 2025-04-21T03:06:08.000Z
- Updated: 2026-09-18T04:53:01.000Z
- Author: Haven Madray
- Tags: 软件开发, Python, #wp-post

Conda 是一个类似于 Poetry 或者 venv 的虚拟环境管理器，只不过 conda 还要多一个系统依赖包管理，例如 conda 可以在虚拟环境里安装 cuda-toolkit 甚至 python-tk。

## 下载

如果你有国际网络环境，那么推荐下载 [miniconda](https://www.anaconda.com/download/success?ref=sgpublic.xyz#:~:text=Miniconda%20Installers)，也可以直接前往[官方文件仓库](https://repo.anaconda.com/miniconda/?ref=sgpublic.xyz)下载。

如果没有，你可以选择下载 [anaconda](https://www.anaconda.com/download/success?ref=sgpublic.xyz#:~:text=our%20Documentation.-,Anaconda%20Installers,-Download)，anaconda 自带了一些常见的包，可以省去后续下载的麻烦。

进入官方文件仓库，你可以选择 Latest 下载，例如“Miniconda3-latest-Windows-x86\_64.exe”；也可以根据 conda 版本下载，例如：“Miniconda3-py39\_25.1.1-2-Windows-x86\_64.exe”，这个文件代表 conda 版本为 25.1.1，conda 内置的 python 版本为 3.9。

需要注意的是，conda 内置的 python 版本，与你实际创建的虚拟环境的 python 版本无关，即你在创建虚拟环境的时候可以选择其他 python 版本，所以通常可以直接选择最新的 python 版本，或直接下载 Latest。

## 安装

### Windows

下载完成后，双击即可安装，Windows 安装到这个界面的时候，我的习惯是按如下截图选择：

![conda 安装选项](https://sgpublic.xyz/content/images/2026/09/QQ20250421-085712.png)

- Create shortcuts：创建快捷方式，我个人不需要这个快捷方式。
- Add Miniconda3 to my PATH environment variable：添加 PATH 环境变量。我个人认为，对于Windows，非必要、或者在你不知道动了之后可能会有什么后果的情况下，不要随意动环境变量。
- Register Miniconda3 as my default Python 3.12：将 miniconda 内置的 python 注册为默认 python 3.12 可执行。经过我的摸索，在初始化完 conda 之后，一个项目需要 conda 时创建虚拟环境即可，所以这个选项没有必要开。
- Clear the package cache upon completion：清除包缓存。可以勾选清除，做干净安装。

如果你选择跟我一样，按如上截图勾选选项，那么你需要记住你安装 miniconda 的位置。即这个界面中默认或你修改的位置：

![conda 安装位置](https://sgpublic.xyz/content/images/2026/09/7ac351ed-faa6-48af-9444-43d1c9cad620.png)

安装完之后，还需要初始化。在 powershell 中，cd 到上述截图中的安装目录，执行 `.\condabin\conda.bat init powershell`。例如我这里安装目录是 `C:\Users\sgpub\AppData\Library\miniconda3`：

```powershell
PS C:\Users\sgpub> cd C:\Users\sgpub\AppData\Library\miniconda3
PS C:\Users\sgpub\AppData\Library\miniconda3> .\condabin\conda.bat init powershell
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\conda.exe
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\conda-env.exe
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\conda-script.py
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\conda-env-script.py
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\conda.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\Library\bin\conda.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\_conda_activate.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\rename_tmp.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\conda_auto_activate.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\conda_hook.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\activate.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\activate.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\condabin\deactivate.bat
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\activate
no change     C:\Users\sgpub\AppData\Library\miniconda3\Scripts\deactivate
no change     C:\Users\sgpub\AppData\Library\miniconda3\etc\profile.d\conda.sh
no change     C:\Users\sgpub\AppData\Library\miniconda3\etc\fish\conf.d\conda.fish
no change     C:\Users\sgpub\AppData\Library\miniconda3\shell\condabin\Conda.psm1
no change     C:\Users\sgpub\AppData\Library\miniconda3\shell\condabin\conda-hook.ps1
no change     C:\Users\sgpub\AppData\Library\miniconda3\Lib\site-packages\xontrib\conda.xsh
no change     C:\Users\sgpub\AppData\Library\miniconda3\etc\profile.d\conda.csh
modified      E:\Documents\WindowsPowerShell\profile.ps1

==> For changes to take effect, close and re-open your current shell. <==

```

### Linux

我这里使用的是 Debian 12，其他系统类似。

使用如下命令即可安装：

```bash
CONDA_INSTALL_PATH=/path/to/miniconda # 路径修改为你想要安装的路径，例如我选择安装到 /opt/miniconda3
mkdir -p $CONDA_INSTALL_PATH # 提前创建安装目录
wget https://repo.anaconda.com/miniconda/Miniconda3-Latest-Linux-x86_64.sh -O $CONDA_INSTALL_PATH/miniconda.sh # 下载安装脚本
bash $CONDA_INSTALL_PATH/miniconda.sh -b -u -p $CONDA_INSTALL_PATH # 执行安装，-b 是静默，-u 是若目标目录已有安装实例则更新实例，-p 是选择安装目录
rm $CONDA_INSTALL_PATH/miniconda.sh # 删除安装脚本（可选）
$CONDA_INSTALL_PATH/bin/conda init bash # 初始化 conda

```

## 使用

Windows 和 Linux 下 conda 使用方法相似，这里使用 Linux 演示。

初始化完成后，重新打开终端，就能使用 conda 命令了。

默认情况下 conda 会默认直接激活默认的 base 环境，我的习惯是不让 conda 激活默认环境，仅在我需要的时候手动激活，使用以下命令禁止此行为：

```bash
conda config --set auto_activate_base false

```

### 创建环境

这里给出一个我比较推荐的实践，即先创建一个模板环境，然后后续新环境基于此环境创建。

cuda 12.x（例如 cuda 12.6、cudnn 9、python 3.10）：

```bash
conda create -n cuda126-cudnn9-py310 python=3.10 nvidia::cuda-toolkit=12.6 nvidia::cudnn=9

```

cuda 11.x（例如 cuda 11.0、cudnn 8、python 3.10）：

```bash
conda create -n cuda110-cudnn8-py310 python=3.10 cudatoolkit=11.0 cudnn=8

```

其中 `-n` 是为你的环境设置一个名字。

当你需要为一个项目创建虚拟环境的时候，使用以下命令创建新的环境（例如基于 cuda 12.6、cudnn 9、python 3.10，即 `cuda126-cudnn9-py310` 创建）：

```bash
conda create -n my-project --clone cuda126-cudnn9-py310

```

还可以创建一个基于路径的虚拟环境：

```bash
conda create --prefix ./.conda-env --clone cuda126-cudnn9-py310

```

这样 conda 就会把虚拟环境创建到 `./.conda-env`，而不是放到统一的目录统一管理。

### 激活环境

使用以下命令激活环境（例如激活 `my-project` 环境）：

```bash
conda activate my-project

```

或者激活基于路径的环境：

```bash
conda activate ./.conda-env

```

取消激活：

```bash
conda deactivate

```

> 需要注意的是，截止于 PyCharm 2025.1，PyCharm 在 Windows 平台使用基于路径的 conda 环境时，会出现无法正确激活的问题，可能导致无法加载 dll 文件等：[PY-80523](https://youtrack.jetbrains.com/issue/PY-80523?ref=sgpublic.xyz)。