PyCharm 2025.3 Help

连接到 Web 服务器

PyCharm 区分以下三种 "本地开发 — 部署服务器" 配置:

  • 就地服务器配置。

    在就地服务器配置中,您使用 本地 Web 服务器 ,但与 本地服务器配置 不同,不会在 PyCharm 项目 与服务器文件结构中的项目文件夹之间执行上传、下载或同步。 相反,您在 PyCharm 中直接从服务器文档根目录打开项目文件夹,从而直接在服务器上进行开发。

    创建就地服务器配置

  • 本地服务器配置。

    本地服务器 是在本地或已挂载的文件夹中运行并向本地 URL 地址提供文件的服务器。 在本地服务器配置中,您在 PyCharm 项目 中进行开发,然后将项目文件上传到服务器上的 文档根目录

    创建本地服务器配置

  • 远程服务器配置。

    远程服务器 配置中,服务器在另一台计算机(远程主机)上运行。 要访问远程服务器上的文件,请使用 FTP/SFTP/FTPS/WebDAV 协议。

    创建远程服务器配置

开始之前

启用 FTP/SFTP/WebDAV Connectivity 插件

此功能依赖于 FTP/SFTP/WebDAV Connectivity 插件,该插件随 PyCharm 一起捆绑,并默认启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 FTP/SFTP/WebDAV Connectivity 插件,并选中插件名称旁的复选框。

您可以根据需要定义任意数量的配置,从而在上传、下载设置之间灵活切换。

如果您需要将代码部署到多个服务器,可以创建 服务器组 ,避免分别部署到每台服务器。

服务器访问配置

PyCharm 通过 服务器访问配置 控制与服务器的交互。 无论服务器位于远程主机还是您的计算机上,每次要使用服务器时,您都需要定义一个服务器访问配置。

服务器访问配置 定义以下内容:

  • 服务器类型(就地本地远程)。

  • 服务器运行所在的计算机(主机)。 对于 就地本地 服务器,PyCharm 假定服务器运行的计算机就是您的项目当前所在的计算机。

  • 服务器访问配置根 :可通过该服务器配置访问的服务器层级中的最高级文件夹。

  • 用于访问 服务器配置根 的 URL 地址。

  • 用于传输数据的协议以及连接参数。

  • 本地文件夹(即项目根目录下的文件夹)、服务器上的目标文件夹(本地或远程)与用于访问服务器上数据的 URL 地址之间的对应关系。 这种对应关系称为 映射

    例如,您的项目存储在 C:/Projects/My_Project/ 下,并包含一个文件夹 C:/Projects/My_Project/My_Folder ,而本地服务器的文档根目录位于 C:/xampp/htdocs 下。 您将整个项目树上传到 C:/xampp/htdocs/My_Project 。 在 PyCharm 的术语中, C:/Projects/My_Project/My_Folder 文件夹称为 本地 C:/xampp/htdocs/My_Project/My_Folder 文件夹称为 远程

您可以根据需要定义任意数量的配置,从而在上传、下载设置之间灵活切换。

如果您需要将代码部署到多个服务器,可以创建 服务器组 ,避免分别部署到每台服务器。

默认服务器访问配置

您可以将某个服务器配置设为 默认 ,以便 PyCharm 在以下情况下静默应用该配置:

  1. 设置 对话框(Ctrl+Alt+S )中,转到 构建、执行、部署 | 部署 ,在中间窗格中选择所需的服务器访问配置,然后在工具栏上点击 设为默认按钮

    或者,点击 PyCharm 状态栏中的 默认部署服务器 小部件,然后在弹出菜单中选择所需的服务器或服务器组。

  2. 配置上传到默认服务器 ,请转到 构建、执行、部署 | 部署 | 选项

最后修改日期: 2025年 12月 2日