【工程记录】vscode+ssh远程配置python环境方法

写在前面

仅作个人学习与记录用。主要记录vscode+ssh远程管理python环境方法。

1. vscode远程连接服务器

启动vscode，点击侧边栏的扩展图标（Extensions）或者按Ctrl+Shift+X。在扩展市场的输入框搜索“Remote” ，选择安装Remote-SSH插件。

确保你有权限通过SSH连接到远程服务器。安装完成后，vscode左侧多出了远程资源管理器图标，如下图点击侧边栏的远程资源管理器图标，点击配置按钮配置远程服务器的地址。选择远程(隧道/SSH)（语言设置为英文的话是SSH Targets）。

接下来点击红框中的加号，或者按下Ctrl+Shift+P打开命令面板，输入Remote-SSH: Connect to Host…并选择它。

接下来输入你的SSH连接信息，格式如下：

ssh 用户名@服务器地址

按enter保存之后，会将刚才的连接信息存储在 C:\Users\[你的用户名]\.ssh\config 中。

此时就可以在SSH中看到添加的远程服务器地址了

如果远程服务器能够连接成功，此时界面上部会出现弹框，需要你输入密码。

如果后续需要免密登录，可以查看这篇教程：vscode设置remote-ssh并免密登录。

2. 本地代码转移至服务器

在VSCode中打开终端，可以点击VSCode左下角的终端图标或者使用快捷键 Ctrl + ~（通常是波浪号键）。

接下来在本地终端（注意不是服务器终端）中使用rsyn命令来同步本地代码到远程服务器。以下是rsync命令的基本格式：

rsync -avz --progress [本地目录路径] [用户名]@[服务器地址]:[远程目录路径]

例如，如果你要将本地项目目录/path/to/local/project同步到远程服务器user@0.0.0.0的/path/to/remote/project目录，可以使用以下命令：

rsync -avz --progress /path/to/local/project user@0.0.0.0:/path/to/remote/project

也可以使用scp命令将文件或目录从本地复制到远程服务器：

scp [本地文件或目录路径] [用户名]@[服务器地址]:[远程目录路径]

例如：

scp /path/to/local/file.txt user@0.0.0.0:/path/to/remote/directory

注意：

• rsync和scp默认不会删除远程服务器上的文件，如果需要删除，可以使用–delete选项或手动执行删除操作。
• 使用–exclude选项来排除不需要同步的文件或目录。
• 确保远程服务器上的目标目录存在，或者使用mkdir -p命令在同步前创建它。
• 如果要复制的文件或目录包含空格，请使用引号将路径括起来。
• scp不会保留文件的权限和所有权信息，如果你需要保留这些信息，可以使用rsync命令的-p（保留权限）和-o（保留所有权）选项。
• 如果远程服务器有密码，输入密码时不显示输入内容是Linux的特性，但实际是有密码输入的。

如果需要代码同步功能，可以参考：VSCode本地代码同步服务器教程

3. 安装anaconda管理环境

3.1 一般情况完整流程

在Anaconda官网下载对应的安装包，地址：Download Now | Anaconda

两种下载方式：

（1）本地下载，拷贝到远程服务器
使用拉取本地文件到服务器的软件（例如MobaXterm）或者在本地终端使用scp命令，例如：

scp root/Anaconda3-2024.10-1-Linux-x86_64.sh user@0.0.0.0:/home/username/documents

如果您在连接时需要指定特定的端口，可以使用 -P 参数指定端口号，例如：

scp -P 22 root/Anaconda3-2024.10-1-Linux-x86_64.sh user@0.0.0.0:/home/username/documents

（2）使用wget命令在远程服务器上直接下载

打开终端，输入：

wget https://repo.anaconda.com/archive/Anaconda3-2024.10-1-Linux-x86_64.sh

直接在sh文件所在的位置使用bash安装即可

bash Anaconda3-2024.10-1-Linux-x86_64.sh

安装过程中一直enter直到出现Do you accept User lincense terms？ [yes|no]: ，选择yes。注意不要错过自定义选择anaconda3文件存放的文件夹路径的环节，也可以在bash安装时就输入：

bash Anaconda3-2024.06-1-Linux-x86_64.sh -b -p /xxx/anaconda3

这个命令可以帮助你直接安装到指定的文件夹下（自动创建），但前提是文件夹下不能之前就存在同名的"anaconda3"文件夹。

安装完成后终端显示: Thank you for installing Anaconda3!

3.2 服务器上存在多个conda的情况

如果服务器上之前就存在多个conda/miniconda，安装流程与3.1一致。

接下来打开你用户目录下的bash配置文件：~/.bashrc，把conda.sh文件的位置都改成刚刚安装好的anaconda3的位置/xxx/anaconda3：

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

然后依次运行下面的命令，激活你的conda环境并验证现在默认的conda是否是你刚刚安装好的anaconda3：

source ~/.bashrc
which conda

4. 创建python虚拟环境

4.1 创建虚拟环境

在远程服务器终端中输入：

#创建虚拟环境
conda create -n your_env_name(虚拟环境的名字) python==X.X(3.8、3.11等)

#如果需要删除虚拟环境
conda env remove --name your_env_name(虚拟环境的名字)

4.2 激活虚拟环境

在远程服务器终端中输入：

#进入虚拟环境
conda activate your_env_name(虚拟环境的名字)

#如果需要退出虚拟环境
conda deactivate