PyCharm 2025.3 Help

在远程主机上编辑单个文件

在与远程主机 设置同步后,您可以直接从远程主机打开单个文件,并在 PyCharm 中进行编辑,而无需将其添加到本地项目或下载到本地。

此类文件不支持调试、重构及 PyCharm 的某些其他功能。 若要利用 PyCharm 的高级功能,建议将这些文件纳入项目。 有关更多信息,请参阅 访问服务器上的文件

在远程主机上编辑文件

  1. 如果您已设置 默认远程主机 ,请在 项目 工具窗口提交 工具窗口 Alt+0 ,或代码编辑器的上下文菜单中选择 部署 | 编辑远程文件

    否则,请执行以下操作:

    1. 在主菜单中选择 工具 | 部署 | 浏览远程主机(B)视图 | 工具窗口 | 远程主机 ,打开 远程主机工具窗口

    2. 从列表中选择所需的部署服务器。 该工具窗口显示 服务器根目录 下的文件和文件夹树形视图。 如果列表中没有相关服务器,请点击 Browse 按钮 ,然后在打开的 部署 对话框中 配置对所需服务器的访问

    3. 双击所需文件,或在上下文菜单中选择 编辑远程文件(M)

      在远程主机上编辑文件
  2. 该文件会在 PyCharm 编辑器中打开,而不会被添加到本地项目或下载到本地。

    在远程主机上编辑文件

    当您处理远程文件时,编辑器顶部会显示一个特殊工具栏,用于显示编辑状态(该文件与远程文件相同该文件已被修改。 是否上传?)。

    远程文件可通过包含服务器名称的标注与本地文件区分开来(在本示例中为 <MyServer>)。

    远程文件标注

  3. 完成文件编辑后,请执行以下操作之一:

    • 要将文件上传到远程主机,请点击 上传当前远程文件 按钮 或按 Alt+Shift+Q

    • 要将当前打开的文件与上次上传的版本进行比较,请点击 与上次上传的版本比较 按钮。 这些文件会在 PyCharm 的 文件差异查看器 中打开。

    • 要放弃上次上传后对该文件所做的更改,请点击

请注意,除非已上传,否则一旦您关闭该文件或当前打开的项目,对单个文件所做的任何更改都会被丢弃。 为防止数据丢失,当您尝试关闭已编辑的文件或整个项目时,PyCharm 会显示以下对话框。

确认上传消息
最后修改日期: 2025年 12月 2日