# 比较已部署的文件和文件夹与其本地版本

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

在 CLion 项目中，文件和文件夹与其服务器上的版本之间的对应关系通过 . 设置。 为了简单起见，CLion 项目中的任何文件或文件夹都称为  本地 ，服务器上的任何文件或文件夹都称为  远程 ，即使服务器实际上安装在您的机器上。 如需了解更多信息，请参阅 [与 Web 服务器同步](configuring-synchronization-with-a-remote-host.html)。

Procedure: 访问服务器

1. 通过从主菜单中选择  `工具 | 部署 | 浏览远程主机` ，打开 [远程主机工具窗口](remote-host-tool-window.html)。

2. 从列表中选择所需的部署服务器。 工具窗口显示了位于  服务器根目录  下的文件和文件夹的树状视图。 如果列表中没有相关的服务器，请点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，在打开的   部署  对话框中 [配置对所需服务器的访问权限](configuring-synchronization-with-a-remote-host.html)。

## 将服务器上的文件和文件夹与本地版本进行比较

每个远程文件或文件夹都 [映射](creating-local-server-configuration.html)到一个且仅一个本地文件或文件夹。 因此，对于每个远程文件或文件夹，CLion 会检测其本地版本，因此您可以随时在   差异查看器  中进行比较。

> **Note:**
> 差异查看器   中的远程文件具有  `read-only`  状态。 这意味着不能直接在   差异查看器   中更新它们。 对该文件的本地版本进行所有必要更改，并将更新后的文件上传到服务器。

Procedure: 将远程文件与本地版本进行比较

1. 打开 [远程主机工具窗口](remote-host-tool-window.html)（  `工具 | 部署 | 浏览远程主机` ），并从列表中选择所需的部署服务器。

2. 选择该文件，然后从其上下文菜单中选择   与本地版本比较  。

3. 在打开的 [文件差异查看器](differences-viewer.html)对话框中，查看差异并在必要时使用 ![从右替换](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.arrow.svg)按钮应用这些差异。 如需更多信息，请参阅 [查看文件之间的差异](comparing-files-and-folders.html#twofiles)。

Procedure: 比较远程文件夹与本地版本

1. 打开 [远程主机工具窗口](remote-host-tool-window.html)（  `工具 | 部署 | 浏览远程主机` ），并从列表中选择所需的部署服务器。

2. 选择文件夹并从选择的上下文菜单中选择   与本地同步  。

3. 在打开的 [文件夹差异查看器](differences-viewer-for-folders.html)中，检查差异并在适用时同步文件。 请参阅 [在 差异查看器 中比较两个文件夹](#compare_folders)。

## 比较本地文件和文件夹与服务器上的版本

由于本地文件或文件夹可以映射到无限数量的远程对应项，CLion 只能在通过 [默认部署服务器](creating-in-place-server-configuration.html)映射时唯一地识别本地文件或文件夹的远程版本。 如果没有指定默认部署服务器，您必须手动选择相关配置。 请注意， [server groups](null) 在服务器选择列表中显示只是为了保持一致性：目前，无法将本地文件与部署到服务器组的文件进行比较。

> **Note:**
> 差异查看器   中的远程文件具有  `read-only`  状态。 这意味着不能直接在   差异查看器   中更新它们。 对该文件的本地版本进行所有必要更改，并将更新后的文件上传到服务器。

Procedure: 将本地文件与其远程版本进行比较

1. 在 [Project](project-tool-window.html) 工具窗口中选择文件。

2. 在上下文菜单中选择  `部署 | 与已部署版本比较 <默认服务器访问配置>`  如果指定了默认服务器。 否则，选择  `与部署到以下服务器的版本比较…` ，然后从列表中选择相关服务器。

3. 在打开的 [文件差异查看器](differences-viewer.html) 对话框中，查看差异并在必要时使用 ![从右侧图标应用](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.arrow.svg) 按钮应用它们。 如需更多信息，请参阅 [查看文件之间的差异](comparing-files-and-folders.html#twofiles)。

Procedure: 将本地文件夹与其远程版本进行比较

1. 在 [Project](project-tool-window.html) 工具窗口中选择文件夹。

2. 从上下文菜单中选择  `部署 | 与已部署到 <默认部署服务器> 的内容同步……` 。 如果未设置默认服务器，请选择  `部署 | 与部署目标同步……`  并选择服务器。

3. 在打开的 [文件夹差异查看器](differences-viewer-for-folders.html)中，检查差异并在适用时同步文件。 请参阅 [在 差异查看器 中比较两个文件夹](#compare_folders)。

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)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))），以查看本地更改的文件。

2. 右键点击文件，然后从上下文菜单中选择   部署 | 与已部署内容比较  ，并从列表中选择目标部署服务器。 如果指定了默认的服务器组，您也可以选择   与已部署内容比较 <默认部署服务器>  。

欲了解更多信息，请参阅 [将文件添加到 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)), `⌘ ⌥ X` (Xcode), `Ctrl+Alt+W` (Visual Studio), `⌘ ⌥ W` (Visual Studio (macOS)), `Ctrl+Alt+W` (ReSharper), `⌘ ⌥ W` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `Ctrl+T` (QtCreator (macOS)), `Ctrl+T` (NetBeans), `Ctrl+T` (Eclipse), `Ctrl+T` (Eclipse (macOS))或从主菜单中选择  `VCS | <VCS> | 更新` ，同步您的本地文件内容与 VCS 仓库。

2. 切换到 [更新信息](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)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS))中。

3. 右键点击文件，然后从上下文菜单中选择   部署 | 与已部署内容比较  ，并从列表中选择目标部署服务器。 如果指定了默认服务器，您也可以选择   与已部署内容比较 <默认部署服务器>  。

## 在 差异查看器 中比较和同步两个文件夹

CLion 提供专用的 [文件夹差异查看器](differences-viewer-for-folders.html)，用于根据文件大小、内容或时间戳比较远程文件夹中的文件及其本地版本。 除了探索差异之外，该工具还提供了一个用于同步文件夹内容的界面。

* 项目列表 显示本地和远程文件夹的内容。 使用 [工具栏按钮](differences-viewer-for-folders.html#toolbar) 缩小或扩大要显示的项目集。 例如，显示或隐藏仅在本地或远程存在的文件、相同的文件、不同的文件、 [从同步中排除的文件](excluding-files-and-folders-from-deployment.html)等。

* 远程文件夹的内容总是显示在右侧窗格，本地版本的内容总是显示在左侧窗格。

* 所选文件的内容显示在下方窗格中，差异会以颜色高亮显示。 差异查看器 中的远程文件具有 `read-only` 状态。 这意味着不能直接在 差异查看器 中更新它们。 对该文件的本地版本进行所有必要更改，并将更新后的文件上传到服务器。

Procedure: 比较两个文件夹

* 在   比较方式   列表中，选择是比较文件内容、大小还是时间戳。

要限制显示的文件，请在   过滤器   中输入模式，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 使用  `*`  匹配任意数量的字符。

选择一个文件，以在下方面板中查看其本地和远程内容。

要切换到另一对要比较的文件夹，请更新它们的完全限定路径。 点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)旁边的   路径  只读字段，并在 [打开的对话框](select-path-dialog.html)中选择所需的文件夹。

![比较文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compareFolders.png)

Procedure: 同步两个文件夹的内容

1. 对于每对项目，   *   字段中的图标指定要应用的操作。 请点击该字段中的图标，直到设置所需操作。

* ![图标箭头右](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.arrow_right.svg) 将上传该文件，可能会覆盖远程版本。

* ![图标箭头左](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.arrow_left.svg) 文件将被下载，可能覆盖本地版本。

* ![图标等于](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.equal.svg) 根据所选比较条件，将文件视为相同。 默认情况下不会执行任何操作。

* ![图标不等](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.not_equal.svg) 根据所选比较条件，文件存在差异。 默认情况下不会执行任何操作。 探索 差异窗格 和 差异查看器 的区别，并通过点击图标更改预期操作。

* ![关闭](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.closeSmall.svg) 文件仅存在于本地或远程，将被移除。

2. 请执行以下操作之一：

* 要同步当前选中的项目，请点击工具栏上的 同步选中 按钮 ![同步选中](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.resume.png)。

* 要同步所有项目，请点击工具栏上的 全部同步 按钮 ![全部同步](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.rerun.svg)。

## See also

### 流程

[部署](deploying-applications.html) [比较文件、文件夹和文本来源](comparing-files-and-folders.html)

### 参考

[文件差异查看器](differences-viewer.html) [文件夹差异查看器](differences-viewer-for-folders.html) [远程主机工具窗口](remote-host-tool-window.html)

