# 上传和下载文件

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

IntelliJ IDEA 提供以下两种方式将项目文件和文件夹上传到 [已配置的部署服务器](configuring-synchronization-with-a-remote-host.html)：

* 手动 ，可随时通过菜单命令。

* 每当文件更新时，或在开始调试会话之前，或在向您的版本控制系统进行提交期间，都会 自动 进行。

> **Tip: 在上传期间使用临时文件名**
> 为减少在上传现有文件的新版本时临时数据丢失的风险，IntelliJ IDEA 可以将上传文件的内容以临时名称存储，并且只在上传操作成功完成后再将其重命名回来。
>
>
>
> 要启用此选项，请转到   设置  （ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）   | 构建、执行、部署 | 部署 | 选项  并勾选   上传时使用临时文件  复选框。

下载文件和文件夹时，IntelliJ IDEA 仅支持  手动 模式。

IntelliJ IDEA 在   文件传输   工具窗口中显示日志。

![文件传输工具窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_file_transfer_tab.png)

Procedure: 启用 FTP/SFTP/WebDAV Connectivity 插件

此功能依赖于 [FTP/SFTP/WebDAV Connectivity](https://plugins.jetbrains.com/plugin/13125-ftp-sftp-webdav-connectivity)插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用 FTP/SFTP/WebDAV 连接插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  FTP/SFTP/WebDAV Connectivity  插件并点击   启用  。

Procedure: 手动上传文件或文件夹

* 在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中，右键点击文件或文件夹，然后从上下文菜单中选择   部署 | 上传到  ，并从列表中选择目标部署服务器或服务器组。

![手动上传文件或文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/upload_file_folder_manually.png)

如果指定了默认服务器或服务器组，您也可以选择   上传到 <default deployment server or server group>  。

Procedure: 上传本地已修改的文件

1. 要查看本地更改的文件，请切换到   提交   窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）。

2. 右键点击文件，然后从上下文菜单中选择   部署 | 上传到  ，并从列表中选择目标部署 。 如果指定了默认的  组，您还可以选择   上传到 <default deployment >  。

有关更多信息，请参见 [将文件添加到 Git 并跟踪更改](adding-files-to-version-control.html)。

Procedure: 与 VCS 存储库同步后上传文件

1. 通过按下 `Ctrl+T` (Windows), `⌘ T` (macOS), `⌘ T` (IntelliJ IDEA Classic (macOS)), `⌘ T` (macOS System Shortcuts), `Ctrl+T` (XWin), `Ctrl+T` (GNOME), `Ctrl+T` (KDE), `Ctrl+T` (Emacs), `Ctrl+T` (Sublime Text), `Ctrl+T` (Sublime Text (macOS)), `Ctrl+Alt+W` (Visual Studio), `⌘ ⌥ W` (Visual Studio (macOS)), `Ctrl+T` (NetBeans), `Ctrl+T` (Eclipse), `Ctrl+T` (Eclipse (macOS))或从主菜单中选择  `VCS | <VCS> | 更新` ，同步您的本地文件内容与 VCS 仓库。

2. 切换到 [Update Info](version-control-tool-window-update-info-tab.html) 选项卡，位于   版本控制   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 中。

3. 右键点击文件，然后从上下文菜单中选择   部署 | 上传到  ，并从列表中选择目标部署 。 如果指定了默认 ，您也可以选择   上传到 <default deployment >  。

Procedure: 提交后立即上传签入的文件

1. 在   提交   窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）中，点击 ![齿轮图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.gear.svg) 以打开提交设置上下文菜单。

2. 在   提交后  菜单区域，从   将文件上传到  列表中选择目标服务器或服务器组。 请选择一个现有的配置或创建一个新配置：点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg)并 [配置对相关服务器的访问](configuring-synchronization-with-a-remote-host.html)，或者在打开的对话框中 [设置服务器组](server-groups.html)。

![将文件上传自 commit 区域后的内容](https://resources.jetbrains.com.cn/help/img/idea/2026.3/upload_files_from_after_commit_area.png)

若要在将来自动应用您的选择，请选中   始终使用所选服务器或服务器组   复选框。

3. 继续 [提交您的更改](commit-and-push-changes.html#commit)。

Procedure: 配置变更文件自动上传到默认服务器或服务器组

IntelliJ IDEA 会在本地文件被自动或手动保存（  `文件 | 全部保存` 或 `Ctrl+S` (Windows), `⌘ S` (macOS), `⌘ S` (IntelliJ IDEA Classic (macOS)), `⌘ S` (macOS System Shortcuts), `Ctrl+S` (XWin), `Ctrl+S` (GNOME), `Ctrl+S` (KDE), `Ctrl+X, Ctrl+S` (Emacs), `Ctrl+S` (Sublime Text), `⌘ S` (Sublime Text (macOS)), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+S` (NetBeans), `Ctrl+S` (Eclipse), `⌘ S` (Eclipse (macOS))）后立即将其视为已更改，请参阅 [保存并撤销更改](saving-and-reverting-changes.html)。 只有在 [默认部署服务器](configuring-synchronization-with-a-remote-host.html#default_server) 上，已更改的文件才能自动上传。

1. 通过执行以下任一操作打开 [选项](settings-deployment-options.html)对话框：

* 前往 `工具 | 部署 | 选项` 。

* 在 设置 对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到 `构建、执行、部署 | 部署 | 选项` 。

2. 从   自动将更改的文件上传到默认服务器   列表中选择您希望 IntelliJ IDEA 上传已更改文件的时间：

* 要上传任何手动或自动保存的文件，请选择 始终 。

* 要仅上传手动保存的文件，请选择 在显式保存操作时 。

* 若要禁止自动上传，请选择 从不 。

3. 如果启用了自动上传，可以选择配置其适用的作用域：

* 选择 跳过外部更改 排除使用第三方工具（如 VCS、脚本等）进行的本地更改，避免自动上传。

* 选择 删除本地文件时同步删除远程文件 以便 IntelliJ IDEA 在本地文件被删除的情况下在自动上传过程中自动删除远程文件。 请注意，此选项作为额外的安全措施，可能导致不需要的文件保留在远程服务器上。 例如，考虑一个本地文件 `FILE.md` ，它被重命名为 `RENAMED.md` 。 由于重命名文件在技术上与删除文件并创建新文件没有区别，自动上传后将发生以下情况： * 如果启用此选项，远程服务器将只包含 `RENAMED.md` 。 * 如果该选项被禁用，自动上传后远程服务器将包含 `FILE.md` 和 `RENAMED.md` 。 您可能需要之后手动删除 `FILE.md` 。

> **Tip:**
> 启用   自动将更改的文件上传到默认服务器   选项还会启用 [上传到默认服务器](saving-and-reverting-changes.html#actions-on-save) 在  `设置 | 工具 | 保存时的操作` 。

Procedure: 下载文件或文件夹

1. 在主菜单中，前往   工具 | 部署 | 浏览远程主机  。

2. 在打开的   远程主机   工具窗口中，选择所需的文件或文件夹，并从所选内容的上下文菜单中选择   从此处下载  。

![下载文件或文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/download_from_here.png)

> **Tip:**
> 要下载文件或文件夹，请配置其服务器路径与本地项目文件夹之间的映射。 不需要 web URL 映射。
>
> 有关详细信息，请参阅：
>
> * [创建本地服务器配置](creating-local-server-configuration.html#mapping)
>
> * [创建远程服务器配置](creating-a-remote-server-configuration.html#mapping)

Procedure: 从默认部署服务器下载文件

1. 在   项目   工具窗口中选择本地文件。

2. 在主菜单中，前往  `工具 | 部署 | 从 <default server> 下载；` 。

IntelliJ IDEA 将提示您覆盖本地文件（如果有）。

## See also

### 过程

[将文件部署到服务器](deploying-applications.html)

### 参考

[部署](settings-deployment.html)