📚 课程目录第3章 Conda环境管理

第3章 Conda环境管理：列表、克隆与重命名

环境管理是Conda日常使用最频繁的操作。说白了，你折腾Python项目、切换不同框架、或者给同事交付依赖环境，都离不开这几个命令。我个人习惯把环境管理分成三块：查（list）、搬（clone）、改名（重命名）。再搞清楚环境到底存在哪个文件夹里，基本就能自由控制了。

3.1 列出所有环境

你手上有多少环境？哪些是激活的？最直接的办法就是跑：

conda env list

输出大概长这样：

# conda environments:
#
base                  *  /home/user/anaconda3
myenv                    /home/user/anaconda3/envs/myenv
torch_env                /home/user/anaconda3/envs/torch_env
legacy                  /home/user/.conda/envs/legacy

注意看，base 后面有个 *，表示当前激活的环境。路径列出来也很清楚——每个环境对应一个独立的文件夹。

小技巧：conda info --envs 和 conda env list 效果完全一样，随便你用哪个。我习惯打 conda env list，因为少敲几个字母。

有的环境路径前面有 *，但不是当前激活的？别慌。如果你用 conda activate myenv 之后，星号就会移到 myenv 前面。另外，conda info 可以查看 root_prefix、envs_dirs 等详细配置，排查路径问题时很实用。

我曾经在服务器上遇到怪事：明明 conda env list 里有环境，但 conda activate 却提示找不到。后来发现是环境文件夹被手动挪动过，但 Conda 的索引没更新。解决办法就是跑一遍 conda info 看看实际路径对不对。

3.2 克隆环境

克隆是我最喜欢的功能之一。你要备份一个环境、复制一份给同事、或者把旧版环境快照下来，都不需要重新装包。命令很简单：

conda create --clone myenv --name myenv_backup

这样就把 myenv 完整的复制了一份，叫做 myenv_backup。所有包版本、pip 安装的第三方库、配置文件都会被复制进去。

应用场景很广：

项目迁移：把开发环境克隆到生产环境，保证二进制版本一致。
版本快照：升级包之前先克隆一份，万一出了问题随时回退。
共享环境：克隆后导出 environment.yml 发给同事，避免手动列包。

  注意：克隆过程不会复制你手动下载的 .tar.bz2 安装包，也不会复制通过 python setup.py install 安装的本地包。如果那种包依赖系统库，克隆后可能需要重新编译。

我在项目里遇到过最头疼的情况：团队里有人用 Windows 开发，有人用 Linux，克隆出来的环境虽然包名一样，但有些二进制包（比如 TensorFlow GPU）在不同平台下编译结果不同。所以克隆跨平台时，我建议还是用 conda env export > environment.yml 导出，再在目标机器上用 conda env create -f environment.yml 重建。

3.3 重命名环境

Conda 没有直接提供 conda env rename 命令。你想想看，它的设计哲学是“环境就是文件夹”，改名本质上就是改文件夹名。但如果你直接改文件夹名，Conda 内部的索引会乱掉，环境可能就废了。

标准做法是两步走：

克隆旧环境到新名字：conda create --clone old_name --name new_name
删除旧环境：conda env remove --name old_name

conda create --clone project_a --name project_b
conda env remove --name project_a

这样既保留了环境的所有包，又把名字换成了新的。我刚开始用 Conda 时，傻傻地做了一次 mv /path/to/envs/old_name /path/to/envs/new_name，结果 conda env list 根本不认，而且 activate 失败。最后还是老老实实克隆+删除解决的。

千万不要直接重命名环境文件夹。Conda 在每个环境目录下存了一些元数据（比如 conda-meta 文件夹里的 JSON 文件），里面记录了环境名。你手动改了文件夹名，但元数据里还是旧名字，activate 时会报错。

3.4 环境路径与存储位置

默认情况下，新创建的环境存放在 /path/to/anaconda3/envs/ 文件夹里。不同操作系统默认路径略有差异：

操作系统	默认环境路径
Linux / macOS	`~/anaconda3/envs/` 或 `~/miniconda3/envs/`
Windows	`C:\Users\用户名\anaconda3\envs\`

你也可以指定自定义路径，用 -p 或 --prefix：

conda create -p /data/projects/my_env python=3.9

这样环境不会放在默认的 envs 文件夹中，而是直接建在指定目录下。优点是方便把环境和项目代码放一起，便于打包移动。缺点是 conda env list 默认不会显示这些非标准路径的环境，除非你激活它。

查看 Conda 配置的所有环境目录列表：

conda config --show envs_dirs

输出类似：

envs_dirs:
  - /home/user/anaconda3/envs
  - /home/user/.conda/envs

Conda 会在这些目录中依次搜索环境名。如果你希望把自定义环境也纳入列表，可以修改 .condarc 文件，把目标目录加到 envs_dirs 中。

3.5 管理多个环境的实践建议

接手的项目多了，环境列表就会越滚越大。我一般遵循几个原则：

命名规范：项目名_用途，比如 nlp_dev、nlp_prod、cv_experiment。
定期清理：超过三个月没使用的环境，先导出 environment.yml 存档，然后删掉。
使用 environment.yml：不要手写包列表，用 conda env export 导出精确版本。

个人习惯：我会在项目根目录放一个 environment.yml 文件，每次更新环境后重新导出一次。这样只要有人拿到项目源码，就能 conda env create -f environment.yml 一秒复现。

下面这张图总结了 Conda 环境管理的核心操作流程，包括创建、列表、克隆、重命名和删除，以及它们之间的关系。

掌握这些命令，你就能像管理代码分支一样管理 Conda 环境，再也不会出现“装了一堆包忘了别名”或者“想回退上个版本只能重装”的尴尬。说白了，Conda 的环境管理就是一套轻量的版本控制——只不过它管的是软件包，不是代码。