PyCharm通过SSH远程连接服务器并运行代码的详细图文教程
本文详细讲解如何在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 远程连接相关内容,建议搜索本站历史文章或继续浏览后续系列教程。感谢大家的支持!
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













