xshell如何安装anaconda Linux环境配置步骤

在 Windows 电脑上使用 Xshell 连接远程 Linux 服务器后，可以直接在终端中部署 Anaconda，从而获得独立的 Python 开发环境。这种做法的好处是无需触碰系统自带的 Python，所有包管理都在用户目录下完成，既安全又便于迁移。完成配置后，每次通过 Xshell 重新登录，都能直接激活环境并使用其中的工具。

Xshell 成功连接远程 Linux 服务器，显示 Bash 命令提示符

本教程基于 Linux x86_64 架构、glibc 2.28 及以上版本以及 Bash 登录 Shell 的环境。开始前，请确保你拥有能正常登录的 SSH 账户，并确认所在组织允许使用 Anaconda。注意，Xshell 只是连接工具，实际的安装命令全部在远程 Linux 会话中执行，不要尝试将 Windows 的安装程序传上去运行。

1. 在 Xshell 会话中核对 Linux 环境

打开 Xshell 中已配置好的服务器会话并登录。确认命令行提示符属于目标 Linux 账户后，依次执行以下命令来检查系统基础信息：

whoami
uname -m
getconf GNU_LIBC_VERSION
ps -p $$ -o comm=
df -h "$HOME"

观察返回结果：架构应为 x86_64，当前进程应为 bash 或 -bash。官方安装器要求 glibc 至少为 2.28，且家目录剩余空间建议大于 5 GB，以便容纳下载文件、安装包及后续创建的环境数据。

如果 uname -m 返回 aarch64，说明是 ARM 架构，需下载对应的 ARM 版安装器，不能继续使用 x86_64 的文件。若系统过旧或非 glibc 环境，请先确认兼容性，不要强行修改系统库。此外，检查家目录下是否已有 anaconda3 文件夹：

ls -ld "$HOME/anaconda3"

若提示不存在，即可按本文进行首次安装；若目录已存在，请先核实其用途，避免覆盖重要数据。

2. 下载同一版本安装器并核对校验值

在本机浏览器访问 Anaconda 官方下载页，找到 Anaconda Distribution 的 Linux x86_64 Shell 安装器。复制最新版本的 .sh 文件直链地址，例如“Anaconda3-2026.07-1-Linux-x86_64.sh”。

回到 Xshell 的远程会话，创建临时目录并下载文件：

mkdir -p "$HOME/anaconda-install"
cd "$HOME/anaconda-install"
read -r -p "粘贴该安装文件的官网下载地址: " installer_url
curl -fL "$installer_url" -o Anaconda3-2026.07-1-Linux-x86_64.sh
sha256sum Anaconda3-2026.07-1-Linux-x86_64.sh

执行 read 命令后，粘贴刚才复制的地址并回车。curl 下载完成后，使用 sha256sum 计算哈希值。务必将计算出的值与官方归档页面中对应文件名的 SHA-256 值逐字比对，完全一致后方可继续。若文件名或版本有变，请同步调整后续命令中的文件名。

在终端中使用 curl 下载安装器并计算 SHA-256 校验值

3. 运行 Linux 安装器，保留用户目录路径

在当前会话中启动安装程序：

bash "$HOME/anaconda-install/Anaconda3-2026.07-1-Linux-x86_64.sh"

按回车键浏览许可协议，输入 yes 表示同意。当提示安装位置时，确认路径为 $HOME/anaconda3（即当前用户家目录下的 anaconda3 文件夹）。此过程不需要 sudo 权限。

运行 Bash 安装脚本，确认安装路径为家目录

若安装器提示目标目录已存在，请暂停并检查旧目录内容，不要直接删除覆盖。安装末尾询问是否初始化 conda 时，建议先输入 no，我们将在下一步手动控制初始化过程，以便更清晰地了解配置变化。

安装结束后，验证核心组件是否就绪：

"$HOME/anaconda3/bin/conda" --version

若能输出版本号，说明二进制文件已正确写入。

4. 初始化 Bash，然后重新连接

使用刚安装的 conda 预览 Bash 初始化将修改的文件：

"$HOME/anaconda3/bin/conda" init --dry-run bash

确认修改指向当前用户的 Shell 配置文件（如 .bashrc）后，执行实际初始化：

"$HOME/anaconda3/bin/conda" init bash

这一步会在配置文件中添加必要的启动脚本。完成后，请正常断开当前的 Xshell 会话，然后重新连接。这是为了让新的登录 Shell 读取更新后的配置。

重新登录会话后，执行 conda --version 验证初始化结果

重新登录后，执行以下命令验证：

conda --version
conda info --base

base 路径应指向 $HOME/anaconda3。即使提示符未显示 (base)，只要命令能执行且路径正确，即表示初始化成功。若提示找不到 conda，请检查当前 Shell 是否为 Bash，或使用绝对路径排查。

5. 创建独立环境并确认 Python 路径

为避免污染基础环境，创建一个名为 xshell-demo 的独立环境：

conda env list
conda create -n xshell-demo python=3.12

确认安装计划后等待完成。若遇到网络或代理问题，请先解决连接报错。创建成功后，激活环境并检查 Python 解释器路径：

conda activate xshell-demo
python --version
python -c 'import sys; print(sys.executable)'

输出应显示 Python 3.12.x，且 sys.executable 路径包含 xshell-demo 字样。这证明当前使用的是环境内的 Python，而非系统自带版本。

6. 重新激活并保存环境配置

退出环境可使用 conda deactivate。为了便于后续重建，导出环境依赖记录：

mkdir "$HOME/xshell-demo-record"
conda env export -n xshell-demo --from-history > "$HOME/xshell-demo-record/environment.yml"

该 YAML 文件记录了显式安装的包，适合版本控制。最后，再次断开并重新连接 Xshell 会话，执行 conda activate xshell-demo，确认在新会话中环境切换依然有效。至此，远程 Linux 上的 Anaconda 环境已配置完毕，可安全用于后续开发任务。

6. 重新激活并保存环境配置