1217 字

6 分钟

机器学习环境配置

2025-10-28

2026-09-17

环境与系统

Windows

conda

/

micromamba

/

Python

/

机器学习

/

Linux

/

VS Code

/

环境配置

为什么选择 micromamba#

micromamba 是使用 conda-forge channel 的 Conda 兼容环境管理器。相比完整 Conda，它更适合无 root 权限的服务器和需要控制安装体积的场景：

使用静态链接的 C++ 可执行文件，安装后可以直接运行；
默认使用 conda-forge channel，软件包覆盖范围较广；
不需要 root 权限，安装和卸载都在用户目录中完成；
安装体积较小，适合服务器环境。

micromamba 也可以管理 JDK、Node.js 和 CUDA 等 Conda 包。是否使用这些包，仍应根据项目需求决定。

TIP
现在可以使用conda进行jdk,node,甚至cuda的安装管理以及隔离

安装 micromamba#

NOTE
下面使用官方安装脚本，不依赖 Homebrew。

官方指导：link

mac, linux, windows git bash:

1
"${SHELL}" <(curl -L micro.mamba.pm/install.sh)

自动升级：

1
micromamba self-update

在远程 VS Code 中使用 micromamba#

安装 Python 与 Python Environments 扩展后，可以让远程 VS Code 将 micromamba 作为 Conda 兼容的环境管理器使用。

远程主机设置#

通过 Remote SSH 连接服务器后，打开命令面板，执行 Preferences: Open Remote Settings (JSON)。对应的远程配置文件通常位于：

1
~/.vscode-server/data/Machine/settings.json

加入以下配置：

1
{
2
  "python-envs.defaultEnvManager": "ms-python.python:conda",
3
  "python.condaPath": "~/micromamba/micromamba"
4
}

其中 python.condaPath 必须指向远程服务器上的 micromamba 可执行文件。如果安装位置不同，可以先执行以下命令确认：

1
command -v micromamba

WARNING
示例使用 ~ 表示当前用户的 home 目录，避免在共享配置、截图或文章中暴露真实用户名。请不要直接写入 /home/<username>/... 或其他包含个人账号的绝对路径。

项目设置#

在项目根目录创建或编辑 .vscode/settings.json：

1
{
2
  "python-envs.pythonProjects": [
3
    {
4
      "path": ".",
5
      "envManager": "ms-python.python:conda",
6
      "packageManager": "ms-python.python:conda"
7
    }
8
  ]
9
}

这里将当前目录声明为 Python 项目，并指定使用 Conda 兼容的环境与包管理器；实际执行程序由远程主机设置中的 python.condaPath 指向 micromamba。

NOTE
python.condaPath 属于远程主机级设置，不要提交到项目的 .vscode/settings.json。这样既能避免泄露服务器目录结构，也能让不同开发者分别配置自己的安装路径。

保存后执行 Developer: Reload Window，再通过 Python: Select Interpreter 或侧边栏的 Python Environments 视图选择环境。若环境未出现，可执行 Python Environments: Refresh All Environment Managers 后重试。

按目录自动加载 Conda 环境#

使用bashrc自动加载(仅在终端创建时自动)文件夹的 conda 环境

可使用man命令来加载最合适的环境(未指定则用父文件夹的)

1
# --- 自动按路径激活 micromamba 环境（从 ~/.conda_map.ini 读取） ---
2
_load_auto_map() {
3
    local file="$HOME/.conda_map.ini"
60 collapsed lines
4
    typeset -gA AUTO_ACTIVATE_MAP
5
    [[ -f "$file" ]] || return
6
    local line key val
7
    while IFS= read -r line || [[ -n "$line" ]]; do
8
        # 删除注释（# 或 ;）和首尾空白
9
        line="${line%%[#;]*}"
10
        line="${line#"${line%%[![:space:]]*}"}"
11
        line="${line%"${line##*[![:space:]]}"}"
12
        [[ -z "$line" ]] && continue
13
        if [[ "$line" == *=* ]]; then
14
            key="${line%%=*}"
15
            val="${line#*=}"
16
            key="${key#"${key%%[![:space:]]*}"}"; key="${key%"${key##*[![:space:]]}"}"
17
            val="${val#"${val%%[![:space:]]*}"}"; val="${val%"${val##*[![:space:]]}"}"
18
            AUTO_ACTIVATE_MAP[$key]="$val"
19
        fi
20
    done < "$file"
21
}
22

23
_find_env_for_dir() {
24
    local pwd="$PWD"
25
    local best_prefix=""
26
    local best_env=""
27
    local prefix
28
    for prefix in "${(@k)AUTO_ACTIVATE_MAP}"; do
29
        # 确保以目录前缀匹配（支持不带斜杠的写法）
30
        if [[ "${pwd%/}" == "${prefix%/}"* ]]; then
31
            if (( ${#prefix} > ${#best_prefix} )); then
32
                best_prefix="$prefix"
33
                best_env="${AUTO_ACTIVATE_MAP[$prefix]}"
34
            fi
35
        fi
36
    done
37
    printf '%s' "$best_env"
38
}
39

40
_auto_activate_on_cd() {
41
    _load_auto_map
42
    local target_env cur_env
43
    target_env="$(_find_env_for_dir)"
44

45
    cur_env="${CONDA_DEFAULT_ENV:-}"
46
    if [[ -z "$cur_env" && -n "$CONDA_PREFIX" ]]; then
47
        cur_env="$(basename "$CONDA_PREFIX")"
48
    fi
49

50
    if [[ -n "$target_env" ]]; then
51
        if [[ "$cur_env" != "$target_env" ]]; then
52
            conda activate "$target_env" >/dev/null 2>&1 || true
53
        fi
54
    else
55
        if [[ -n "$cur_env" && "$cur_env" != "base" ]]; then
56
            conda deactivate >/dev/null 2>&1 || true
57
        fi
58
    fi
59
}
60
_auto_activate_on_cd
61
alias ac=_auto_activate_on_cd
62
# ac 来手动激活对应环境（前缀匹配激活，子文件夹都可用）
63
# --- 结束 自动激活 ---

1
# --- 自动按路径激活 micromamba 环境（从 ~/.conda_map.ini 读取） ---
2
_load_auto_map() {
3
    local file="$HOME/.conda_map.ini"
61 collapsed lines
4
    # 使用全局关联数组
5
    declare -gA AUTO_ACTIVATE_MAP=()
6
    [[ -f "$file" ]] || return
7
    local line key val
8
    while IFS= read -r line || [[ -n "$line" ]]; do
9
        # 删除注释（# 或 ;）和首尾空白
10
        line="${line%%[#;]*}"
11
        line="${line#"${line%%[![:space:]]*}"}"
12
        line="${line%"${line##*[![:space:]]}"}"
13
        [[ -z "$line" ]] && continue
14
        if [[ "$line" =~ ^([^=]+)=(.+)$ ]]; then
15
            key="${BASH_REMATCH[1]}"
16
            val="${BASH_REMATCH[2]}"
17
            key="${key#"${key%%[![:space:]]*}"}"; key="${key%"${key##*[![:space:]]}"}"
18
            val="${val#"${val%%[![:space:]]*}"}"; val="${val%"${val##*[![:space:]]}"}"
19
            AUTO_ACTIVATE_MAP["$key"]="$val"
20
        fi
21
    done < "$file"
22
}
23

24
_find_env_for_dir() {
25
    local pwd="$PWD"
26
    local best_prefix=""
27
    local best_env=""
28
    local prefix
29
    for prefix in "${!AUTO_ACTIVATE_MAP[@]}"; do
30
        # 确保以目录前缀匹配（支持不带斜杠的写法）
31
        if [[ "${pwd%/}" == "${prefix%/}"* ]]; then
32
            if (( ${#prefix} > ${#best_prefix} )); then
33
                best_prefix="$prefix"
34
                best_env="${AUTO_ACTIVATE_MAP[$prefix]}"
35
            fi
36
        fi
37
    done
38
    printf '%s' "$best_env"
39
}
40

41
_auto_activate_on_cd() {
42
    _load_auto_map
43
    local target_env cur_env
44
    target_env="$(_find_env_for_dir)"
45

46
    cur_env="${CONDA_DEFAULT_ENV:-}"
47
    if [[ -z "$cur_env" && -n "$CONDA_PREFIX" ]]; then
48
        cur_env="$(basename "$CONDA_PREFIX")"
49
    fi
50

51
    if [[ -n "$target_env" ]]; then
52
        if [[ "$cur_env" != "$target_env" ]]; then
53
            conda activate "$target_env" >/dev/null 2>&1 || true
54
        fi
55
    else
56
        if [[ -n "$cur_env" && "$cur_env" != "base" ]]; then
57
            conda deactivate >/dev/null 2>&1 || true
58
        fi
59
    fi
60
}
61
_auto_activate_on_cd
62
alias ac=_auto_activate_on_cd
63
# ac 来手动激活对应环境（前缀匹配激活，子文件夹都可用）
64
# --- 结束 自动激活 ---

验收结果#

无 root 权限或希望减少安装体积时，推荐使用 micromamba 管理 Conda 环境。
远程 VS Code 中，将 python.condaPath 指向 micromamba，并为项目设置 Conda 环境管理器，即可完成环境发现、选择和包管理。
主机相关路径应放在远程 Machine 设置中，项目配置只保留可共享内容，避免暴露用户名和服务器目录结构。