PyCharm 2025.3 Help

创建本地服务器配置

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

要在 PyCharm 中创建本地服务器配置,您需要在 PyCharm 与服务器之间 设置连接 ,并 配置映射 ,使 PyCharm 项目与服务器上的项目文件夹及其对应的 URL 路径相对应。

1. 指定服务器配置的名称、类型和可见性

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 部署

    或者,在主菜单中转到 工具 | 部署 | 配置

  2. 在列出所有现有服务器配置的左侧窗格中,点击 添加 添加项 ,并在弹出菜单中选择 本地或已挂载的文件夹

    添加本地或已挂载文件夹
  3. 在打开的 创建新服务器 对话框中,键入要创建的服务器名称,然后点击 确定创建新服务器 对话框关闭,您将返回 部署 节点的 连接 选项卡。

  4. 在服务器列表中,选择要设为默认的服务器,然后点击服务器列表上方工具栏中的 设为默认按钮设为默认将服务器标记为默认

  5. 清除 仅对此项目可见 复选框,以便在其他项目中复用此服务器访问配置。

2. 设置与服务器的连接

连接 选项卡(Ctrl+Alt+S| 构建、执行、部署 | 部署 )中,指定服务器设置:

  • 文件夹 :指定服务器文档根在您的服务器配置文件中定义的绝对路径。 除文档根本身外,还可以指定文档根下的任何其他现有文件夹。

    文档根是 Web 服务器向其 URL 提供文件的文件夹。

  • Web 服务器 URL :在服务器配置文件中映射到服务器文档根的 URL 地址(主机名和(可选)端口)。 这是应用程序 Web 地址的基础 URL。 两者 HTTPHTTPS 都支持。

    点击该字段右上角的 浏览 以打开并检查提供的 Web 服务器 URL。

3. 将项目文件夹映射到服务器文件夹和 URL 路径

映射 选项卡(Ctrl+Alt+S| 构建、执行、部署 | 部署 )中,指定在 PyCharm 中打开的项目与服务器文档根下与其对应的文件夹之间的映射:

部署的映射选项卡
  • 本地路径 :本地项目文件夹的绝对路径。 PyCharm 会自动使用当前打开的项目路径填充此字段。

  • 部署路径 :服务器文档根下的某个文件夹,PyCharm 会将 本地路径 字段中指定的项目文件夹内容上传到此处。

    如果服务器上尚不存在具有指定名称的文件夹,则在您触发 项目上传 时,PyCharm 会创建它。

    最简单的方法是将整个项目根文件夹映射到服务器文档根下的某个文件夹。 在这种情况下,服务器上将重建项目文件夹结构。

  • Web 路径 :为 部署路径 中指定的文件夹配置的 URL 路径。 您可以使用斜杠(/ )指向根文件夹;如果无法通过 Web 访问该目录,则可将该字段留空。

现在已添加服务器配置,您可以在 远程主机工具窗口 中访问服务器的文件和文件夹。 在主菜单中转到 工具 | 部署 | 浏览远程主机 ,在打开的工具窗口中,从下拉列表中选择已配置的服务器。

打开远程主机工具窗口并选择该服务器
最后修改日期: 2025年 12月 2日