Windows Git Bash Conda配置指南

本文最后更新于 2026年4月30日 晚上

一、问题背景

Git Bash 是类 Unix Shell,conda 默认不会自动初始化,会出现:

  • conda activate 报错:CondaError: Run 'conda init' before 'conda activate'
  • conda 环境名不显示显示格式混乱

二、核心配置步骤

Git Bash 路径统一用 / 不要用 \

步骤 1:在 Git Bash 中初始化 conda

1
D:/miniconda3/Scripts/conda init bash

步骤 2:配置 ~/.bashrc

打开配置文件:

1
code ~/.bashrc

写入以下完整内容(替换成你的 conda 路径):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 防止中文乱码
export LC_ALL=zh_CN.UTF-8
export LANG=zh_CN.UTF-8

# >>> conda initialize >>> 懒加载,加快bash加载速度
conda() {
unset -f conda
eval "$('D:/miniconda3/Scripts/conda.exe' 'shell.bash' 'hook')"
conda "$@"
}
# <<< conda initialize <<<

# 让 conda 环境名显示在提示符左侧(固定格式)
show_conda_env() {
if [ -n "$CONDA_DEFAULT_ENV" ]; then
echo "($CONDA_DEFAULT_ENV) "
fi
}

export PS1='\[\033[0;35m\]$(show_conda_env)\[\033[0;32m\]\u@\h\[\033[00m\] \[\033[0;34m\]\W\[\033[00m\]\$ '

步骤 3:必须开启 changeps1(核心关键)

这一步必须执行,否则环境名不会显示:

1
conda config --set changeps1 true

查看是否开启成功:

1
conda config --show changeps1

显示 changeps1: true 即成功。

步骤 4:检查 .bash_profile(一般自动生成)

确保文件能加载 .bashrc 即可,内容如下:

1
2
test -f ~/.profile && . ~/.profile
test -f ~/.bashrc && . ~/.bashrc

步骤 5:重启 Git Bash 验证

关闭重新打开,运行:

1
conda activate base

成功效果:

1
(base) 用户名@主机 MINGW64 ~ $

三、颜色配置说明

颜色代码 颜色 内容
0;35m 紫色 conda 环境名
0;32m 绿色 用户名@主机
0;34m 蓝色 当前目录

四、常见问题排查

  1. 环境名不显示
    一定是 changeps1 没开:

    1
    conda config --set changeps1 true
  2. conda: command not found
    重新执行初始化:

    1
    D:/miniconda3/Scripts/conda init bash
  3. 重启终端才生效
    任何配置修改都必须重启 Git Bash



Windows Git Bash Conda配置指南
https://xinhaojin.github.io/2026/04/30/Windows Git Bash Conda配置指南/
作者
xinhaojin
发布于
2026年4月30日
许可协议