PyCharm 2025.3 Help

自定义上传和下载

除了确保在各种项目—服务器设置中成功上传和下载的必需设置之外,您还可以配置其他选项,以自定义与服务器的交互。 这些选项中的大多数适用于所有 服务器访问配置 类型。 对于 FTP、FTPS 和 SFTP 服务器配置,您可以指定其他特定于协议的选项。

设置通用上传和下载选项

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

    或者,在主菜单中转到 工具 | 部署 | 选项...

  2. 指定其他设置:

    • 要在上传和下载期间跳过特定文件或整个文件夹,请在 通过名称排除项 字段中指定用于定义这些文件和文件夹名称的模式。

      使用分号 ; 作为分隔符,星号 * 用于匹配零个或多个字符,问号 ? 用于匹配单个字符。

      例如,如果您有一个文件夹 stylesheets ,其中包含三个文件 style.css style1.css style2.scss ,则 style* 会排除整个文件夹, style?.css 会排除 style1.css ,而 style?.* 会排除 style1.css style2.scss

      Regular-Expressions.info 上了解更多信息。

      排除规则将递归应用。 这意味着,如果匹配的文件夹包含子文件夹,这些子文件夹的内容也不会部署。

      有关更多信息,请参阅 从上传/下载中排除文件和文件夹

    • 通过选中或清除相应的复选框来指定上传和下载过程的详细信息。

指定其他特定于协议的自定义选项

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

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

  2. 选择一个已配置的服务器,并在 连接 选项卡上展开 高级 组,以指定取决于协议的其他上传设置:

    • 连接数(E) 字段中,指定要同时支持的最大连接数。

    • 发送保持活动消息的间隔(K) 字段中,指定 PyCharm 向服务器发送命令以重置超时从而保持连接的频率。

    • 客户端-服务器通信编码 (E) 字段中,指定与您的服务器使用的编码匹配的编码。 如果不确定其是否支持 UTF-8 编码,请接受默认值。

    • 要将客户端设置为 被动模式 ,请选择 被动模式(P) 复选框。 在此模式下,您计算机上的客户端会连接到服务器以告知其处于被动模式,接收要侦听的端口号,并通过收到的端口号建立数据连接。 当您的计算机位于防火墙之后时,此模式很有用。

    • 要在 服务器浏览器工具窗口 中显示隐藏文件和目录(名称以点 . 开头),请选择 显示并处理隐藏文件(S)

    • 使用LIST 命令 区域选择 与旧版本的列示子项兼容(C) ,以确保与您的 FTP 服务器的 子文件命名兼容性

      如果远程 FTP 服务器报告以下错误,则此选项很有用:

      Invalid descendant file name <file name>

      选择此选项可能会降低与服务器的同步速度。

    • 使用LIST 命令 区域选择 代替MLSD ,以使用标准的 LIST 命令用于列出,而不是使用 MLSD 命令。 这可让您避免出现问题,例如当 FTP 服务器支持 MLSD 并返回 cdir 时,上传失败并抛出 Invalid descendent file name 异常。

    • 连接数(E) 字段中,指定要同时支持的最大连接数。

    • 发送保持活动消息的间隔(K) 字段中,指定 PyCharm 向服务器发送命令以重置超时从而保持连接的频率。

    • 保持活动命令(A) 列表中,选择要发送到服务器以重置超时从而保持连接的命令。

    • TLS :传输层安全性的方式。 选择 显式(X) 以使用与普通(非安全)模式相同的端口,或选择 隐式(I) 以使用专用端口。

    • 数据通道保护级别(D) :选择 清除 表示非安全连接,或选择 Private 表示安全连接。

    • 重用SSL 会话 :选择以重用在 SSL 连接期间建立的安全会话,包括密钥和算法协议信息。

    • 禁用TLS 1.3 :选择以禁用 TLS 1.3 功能,使 PyCharm 回退为通过 TLS 1.2 进行连接。 如果在与服务器建立连接或上传某些文件时遇到问题,请使用此选项。

    • 要将客户端设置为 被动模式 ,请选择 被动模式(P) 复选框。 在此模式下,您计算机上的客户端会连接到服务器以告知其处于被动模式,接收要侦听的端口号,并通过收到的端口号建立数据连接。 当您的计算机位于防火墙之后时,此模式很有用。

    • 要在 服务器浏览器工具窗口 中显示隐藏文件和目录(名称以点 . 开头),请选择 显示并处理隐藏文件(S)

    • 使用 LIST 命令 区域选择 与旧版本的列示子项兼容(C) ,以确保与您的 FTP 服务器的 子文件命名兼容性

      如果远程 FTP 服务器报告以下错误,则此选项很有用:

      Invalid descendant file name <file name>

      选择此选项可能会降低与服务器的同步速度。

    • 使用LIST 命令 区域选择 代替MLSD ,以使用标准的 LIST 命令用于列出,而不是使用 MLSD 命令。 这可让您避免出现问题,例如当 FTP 服务器支持 MLSD 并返回 cdir 时,上传失败并抛出 Invalid descendent file name 异常。

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