PyCharm通过SSH远程连接服务器并运行代码的详细图文教程

纸上星河
纸上星河
发布时间:2026-10-12| 2人浏览过
原创

本文详细讲解如何在PyCharm中通过SFTP协议建立SSH远程连接,配置Python解释器及文件映射路径,实现本地代码与远程服务器的同步。涵盖连接测试、环境设置、代码上传下载及运行验证全流程,帮助开发者高效进行远程开发。

首先,连接远程服务器,依次点击菜单栏中的 Tools -> Deployment -> Configuration。

在连接窗口中,点击“+”号并选择 SFTP 选项,随后为该连接配置一个易于识别的名称。

点击 SSH 配置项后的省略号按钮,依次输入远程服务器的 IP 地址、用户名以及登录密码。

点击“Test Connection”按钮,以验证网络连接是否成功建立。

测试通过后点击“确定”返回上一界面。此时需关注 Root path 设置,即服务器上的根目录路径。该路径可选填,但若留空,后续在 Remote Host 中查看文件时路径显示会较为冗长,建议根据实际需求指定具体路径。

点击“Mappings”选项卡以设置路径映射关系。其中,“Local path”指定本地项目目录,通常保持默认即可;“Deployment path”则指定代码上传至服务器的目标路径,本地代码将同步提交至此路径下。

完成上述所有设置后,点击“确定”保存配置。

随后依次点击 Tools -> Deployment -> Browse Remote Host,此时会弹出 Remote Host 窗口。若未自动显示,请点击下拉三角菜单并选择之前设置好的 SFTP 连接。界面显示正常即表示连接成功,如下图所示。

接下来进行 Python 解释器的配置。

依次点击 File -> Settings -> Project -> Python Interpreter 进入解释器设置界面。

点击齿轮图标并选择“Add”添加新解释器。注意:系统中存在多个解释器可能会影响代码运行,建议在添加前点击“Show All”检查是否存在多余的解释器,如有则先将其删除,以确保环境纯净。

在添加窗口中选择“SSH Interpreter”,并从下拉菜单中选择之前配置好的 SSH 连接环境。

点击“Next”继续。首次连接时下方会显示一段同步对话提示,点击“Move”即可继续操作。

“Interpreter”字段显示服务器端解释器的具体路径,一般情况下无需修改。若路径缺失,可点击旁边的文件夹图标,手动导航至服务器中对应的 Python 解释器文件并选中。

“Sync folders”用于设置本地路径与服务器远程路径的映射关系,用户可选择默认设置或自定义指定路径。

确认所有信息无误后,点击“确定”,随后点击“Finish”完成配置。

若界面显示如下状态,则表明解释器配置已成功生效。

完成环境配置后,即可进行代码的上传与下载操作。

关于下载操作,找到之前在 Mappings 中配置的文件路径,右键点击目标文件并选择“Download”。

下载成功后,本地目录中会出现对应的 .py 文件。运行该文件,若输出结果符合预期,则说明远程代码同步与运行配置成功。

若需将本地代码更新至服务器,则选择“Upload”进行上传操作。

总结

至此,关于 PyCharm 通过 SSH 远程连接服务器并运行代码的教程已介绍完毕。如需了解更多 PyCharm SSH 远程连接相关内容,建议搜索本站历史文章或继续浏览后续系列教程。感谢大家的支持!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。