Ubuntu22.04下Miniconda初始化失败（UnicodeDecodeError）求助

问题背景 #

在全新安装的Ubuntu 22.04系统（已预装Python 3.10和Python 3.11）中，按官方步骤安装Miniconda后执行初始化操作时触发以下错误：

UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 6204: invalid continuation byte

已尝试以下方案但未解决：

• 安装Python 3.11后使用最新版Miniconda安装包
• 使用旧版本Miniconda安装包（py310_23.5.2-0）
• 安装时选择自动初始化
• 激活base环境后执行conda init
• 替换为安装Anaconda
• 重新配置locales包排查编码问题

问题原因 #

从报错栈可以看出，conda init在读取shell配置文件（如~/.bashrc、~/.zshrc）时，遇到了非UTF-8编码的字符（0xe9）。这类字符通常是其他编码（如Latin-1、GBK）的残留，导致Python无法正常解码文件内容。

解决方案 #

1. 定位并修复配置文件中的异常字符 #

• 检查目标配置文件的编码：

  file -i ~/.bashrc
  

  若输出不是charset=utf-8，说明文件编码存在问题。
• 查看报错位置附近的内容：

  sed -n '6200,6210p' ~/.bashrc
  

  找到位置6204附近的异常字符，直接删除或替换为UTF-8编码的对应字符。

2. 手动添加Miniconda初始化代码 #

绕过conda init的自动读取逻辑，手动将初始化代码写入shell配置文件：

• 打开你的shell配置文件（以bash为例）：

  nano ~/.bashrc
  

• 添加以下代码（注意替换为你的Miniconda安装路径）：

  # >>> conda initialize >>>
  __conda_setup="$('/home/sady/miniconda3/bin/conda' 'shell.bash' 'hook' 2> /dev/null)"
  if [ $? -eq 0 ]; then
      eval "$__conda_setup"
  else
      if [ -f "/home/sady/miniconda3/etc/profile.d/conda.sh" ]; then
          . "/home/sady/miniconda3/etc/profile.d/conda.sh"
      else
          export PATH="/home/sady/miniconda3/bin:$PATH"
      fi
  fi
  unset __conda_setup
  # <<< conda initialize <<<
  

• 保存文件后重新加载配置：

  source ~/.bashrc
  

3. 强制系统使用UTF-8编码 #

确保系统默认编码为UTF-8，避免后续编码冲突：

sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8

重启终端或重新登录系统后，验证编码配置：

locale

验证 #

执行以下命令确认Miniconda正常工作：

conda --version
conda activate base

内容的提问来源于stack exchange，提问作者sasaak