PyCharm

PyCharm Professional 支持通过 SSH 连接远程实例，使用远程 Python 解释器进行代码开发、调试和运行。
警告： 如果使用 PyCharm 直接运行或在终端中执行训练程序，请在调试完成后使用 screen 或 tmux 开启守护进程，确保程序不受 PyCharm 或 SSH 连接中断影响。具体使用方法请参考守护进程文档。

官方文档：配置基于 SSH 的远程 Python 解释器

使用前准备

在进行操作前，您需要提前准备好以下内容：

安装 PyCharm Professional；

在OLA Cloud租用并开机实例；

获取实例的 SSH 登录信息，包括登录指令和登录密码；

准备需要在远程实例中使用的 Python 环境。

PyCharm Community 不支持通过 SSH 配置远程 Python 解释器，本文需要使用 PyCharm Professional。

1.登录 OLA Cloud 获取实例的 SSH 信息

登录OLA Cloud，进入“容器管理”，启动需要使用的实例。

在实例详情或连接信息中找到 SSH 登录指令，并复制完整命令。下面以以下命令为例：

这条命令中各个参数的含义如下：

用户名：root

主机（host）：123.xxx.xxx.32

端口号：30220

注意： 每个实例的 SSH 主机和端口都可能不同，请以当前实例页面显示的登录指令为准，不要直接照抄示例中的地址和端口。

2.打开 PyCharm 的 Python 解释器设置

打开 PyCharm 项目，依次点击“文件 -> 设置”，在设置窗口中选择“项目 -> Python 解释器”。

点击 Python 解释器右侧的“添加解释器”，选择“在 SSH 上”。

如果找不到“在 SSH 上”选项，请确认当前使用的是 PyCharm Professional，而不是 Community 版本。

3.配置 SSH 连接

在 SSH 解释器配置页面中，填写实例 SSH 登录信息：

主机（Host）：填写 SSH 指令中的主机地址，例如 123.xxx.xxx.32；

端口（Port）：填写 SSH 指令中的端口号，例如 30220；

用户名（Username）：填写 root。

第一次连接可能会出现“无法确认xxx主机的真实性，是否确认连接”的弹窗，确认主机端口无误后点击确认按钮即可。

点击“下一步”，输入实例的 SSH 登录密码。

用户名、主机和端口需要以当前实例页面显示的 SSH 指令为准。OLA Cloud 实例的用户名通常为 root。

4.配置远程 Python 解释器和同步目录

继续下一步，直到进入项目目录和Python运行时配置页面。选择 选择现有，并配置远程 Python 解释器路径。

首先在类型中选择需要使用的类型，通常为 Python。新版 PyCharm 通常会自动检测远程解释器；如果检测失败，可手动填写解释器路径。

如果使用 Miniconda 默认环境，解释器路径通常为：

/root/miniconda3/bin/python3

如果使用 Miniconda 中创建的其他虚拟环境，解释器路径通常为：

/root/miniconda3/envs/{对应的虚拟环境名称}/bin/python3

将 {对应的虚拟环境名称} 替换为实际的虚拟环境名称，例如：

/root/miniconda3/envs/myenv/bin/python3

接着配置同步目录。同步目录用于关联本地项目目录和远程实例中的项目目录，建议将远程实例的项目目录设置为实例的数据盘目录，例如：

/root/ola-data/project/

不建议使用默认的 /tmp 目录，因为该目录中的文件可能会被系统清理或不适合长期保存项目代码。

确认配置无误后，点击“创建”或“确定”。PyCharm 会进行短暂配置，完成后即可使用远程 Python 解释器进行开发。

5.同步项目代码

配置远程解释器后，PyCharm 通常会自动将本地项目代码同步到设置的远程目录中。

如果运行程序时找不到 Python 文件，或者远程目录中没有最新代码，可能是代码没有自动同步。此时可以在 PyCharm 的“工具”菜单中找到部署相关选项，手动执行“上传到”或“同步”操作。

请检查以下内容：

本地项目目录是否配置正确；

远程同步目录是否配置正确；

当前文件是否已经保存；

PyCharm 是否仍然连接着远程实例。

6.打开 PyCharm 远程终端

配置好 PyCharm 远程开发后，可以在 PyCharm 底部的“终端”工具窗口中打开远程终端。

如果终端窗口中存在多个终端环境，可以通过终端下拉菜单选择远程服务器对应的终端。

在远程终端中执行的命令会直接作用于远程实例。请注意区分本地终端和远程终端，避免将安装依赖或运行程序的命令执行到错误的环境中。

7.运行和调试远程代码

完成远程解释器配置后，PyCharm 的运行和调试功能会使用远程实例中的 Python 环境执行代码。运行前建议确认项目使用的解释器显示为刚刚配置的 SSH 远程解释器。

您也可以在 PyCharm 的终端中执行以下命令，检查当前远程环境：

如果项目依赖尚未安装，可以在 PyCharm 的远程终端中进入项目目录后执行：

请根据实际项目目录和依赖文件位置修改命令。

8.长时间运行程序时使用 screen

如果直接在 PyCharm 的运行窗口或普通远程终端中运行训练程序，PyCharm 或 SSH 连接断开后，程序可能会被一并终止。因此，调试完成后，强烈建议使用 screen 或 tmux 运行需要长时间执行的程序。

详情请参考守护进程文档。

9.常见问题

找不到“在 SSH 上”选项

请确认使用的是 PyCharm Professional。PyCharm Community 不支持通过 SSH 配置远程 Python 解释器。

SSH 连接失败

请检查以下内容：

实例是否已经开机并处于运行状态；

用户名是否为实例页面提供的用户名，通常为 root；

SSH 密码是否正确；

SSH 主机地址和端口号是否填写完整、正确；

是否误删了 SSH 指令中的 -p 参数或端口号；

本地网络或代理是否拦截了 SSH 连接。

找不到远程 Python 解释器

请确认解释器路径填写正确。Miniconda 默认环境通常使用：

/root/miniconda3/bin/python3

如果使用其他虚拟环境，请填写对应环境下的 bin/python 路径。

运行时找不到 Python 文件

请检查本地代码是否已经同步到远程实例，并确认运行配置中的工作目录和项目路径正确。必要时可以手动执行上传或同步操作。

关闭 PyCharm 后程序停止

如果程序是在普通远程终端或 PyCharm 运行窗口中直接执行的，断开连接后程序可能会终止。请使用 screen 或 tmux 重新启动程序，并通过日志文件查看运行情况。

远程终端中找不到命令或依赖

请确认当前终端确实连接到了远程实例，并检查使用的 Python 解释器和虚拟环境是否正确。安装依赖时，应在远程终端中执行命令，而不是在本地终端中执行。

使用前准备#

1.登录 OLA Cloud 获取实例的 SSH 信息#

2.打开 PyCharm 的 Python 解释器设置#

3.配置 SSH 连接#

4.配置远程 Python 解释器和同步目录#

5.同步项目代码#

6.打开 PyCharm 远程终端#

7.运行和调试远程代码#

8.长时间运行程序时使用 screen#

9.常见问题#

找不到“在 SSH 上”选项#

SSH 连接失败#

找不到远程 Python 解释器#

运行时找不到 Python 文件#

关闭 PyCharm 后程序停止#

远程终端中找不到命令或依赖#