部署您的应用程序＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

在配置开发和生产环境的众多方法中，最常见的方法如下：

• Web服务器安装在您的计算机上。源位于服务器文档根目录下（例如，在/ htdocs文件夹中），您可以直接在服务器上进行开发。

• Web服务器安装在您的计算机上，但源存储在另一个文件夹中。您进行开发，然后将源复制到服务器。

• Web服务器位于另一台计算机（远程主机）上。服务器上的文件可通过FTP / SFTP / FTPS协议，网络共享或已安装的驱动器获得。

IntelliJ IDEA假定所有开发，调试和测试都在您的计算机上完成，然后将代码部署到生产环境中。

坚持这种“本地开发 - 部署”模式的原因在于IntelliJ IDEA提供编码帮助的方式，包括代码完成，代码检查和验证，代码导航等。所有这些功能都基于 项目文件索引，IntelliJ IDEA在项目加载时构建，并在编辑代码时动态更新。

为了提供有效的编码帮助，IntelliJ IDEA需要快速重新编码代码，这需要快速访问项目文件。后者只能用于本地文件，即存储在硬盘上并可通过文件系统访问的文件。

IntelliJ IDEA与服务器之间的交互＃ 

IntelliJ IDEA与服务器之间的交互通过服务器访问配置进行控制 。无论您何时使用服务器，都需要定义服务器访问配置，无论您的服务器是在远程主机上还是在您的计算机上。

考虑到以上所有因素，我们定义以下与IntelliJ IDEA和服务器之间的同步相关的基本概念。

• 一个就地服务器是服务器，其文档根目录是项目的根的父母，无论是直接的还是不行。换句话说，Web服务器正在您的计算机上运行，​​您的项目位于其文档根目录下（例如，在/ htdocs文件夹中），您可以直接在服务器上进行开发。

• 一个本地服务器是在本地或安装文件夹中，并且其运行的服务器 文档根目录是不是项目的根的父。您进行开发，然后将源复制到服务器。

• 甲远程服务器是另一个计算机（远程主机）上运行的服务器。可以通过FTP / SFTP / FTPS协议访问服务器上的文件。

• 该服务器配置的根是在上的文件树中的*文件夹的本地或远程通过服务器配置访问的服务器。对于就地服务器，它是项目根目录。

• 一个本地文件/文件夹是项目的根目录下的任何文件或文件夹。

• 甲远程文件/文件夹是服务器上的任何文件或文件夹。

• 上传是将数据从项目复制到服务器（本地或远程）。

• 下载是将数据从服务器复制到项目。

配置与服务器的同步后，您可以直接从IntelliJ IDEA上载，下载和管理文件。此外，您可以禁止上载或下载特定文件或整个文件夹。最后，您可以通过配置内容根来优化工作流，这样特定文件夹就不会参与索引，从而显着节省了项目索引时间。

通过Remote Hosts Access捆绑插件提供与服务器同步，上载，下载和管理文件，默认情况下启用该插件。如果禁用该插件，请在“设置”对话框的“ 插件”页面中将其**。有关详细信息，请参阅管理插件。请注意，该插件仅适用于IntelliJ IDEA 的Ultimate Edition。

配置与Web服务器的同步＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

在配置开发和生产环境的众多方法中，最常见的方法如下：

• Web服务器安装在您的计算机上。源位于服务器文档根目录下（例如，在/ htdocs文件夹中），您可以直接在服务器上进行开发。

• Web服务器安装在您的计算机上，但源存储在另一个文件夹中。您进行开发，然后将源复制到服务器。

• Web服务器位于另一台计算机（远程主机）上。服务器上的文件可通过FTP / SFTP / FTPS协议，网络共享或已安装的驱动器获得。

IntelliJ IDEA区分了就地服务器，本地服务器和 远程服务器，但IntelliJ IDEA上下文中这些术语的含义与它们的常见含义略有不同：

• 一个就地服务器是服务器，其文档根目录是项目的根的父母，无论是直接的还是不行。换句话说，Web服务器正在您的计算机上运行，​​您的项目位于其文档根目录下（例如，在/ htdocs文件夹中），您可以直接在服务器上进行开发。

• 一个本地服务器是在本地或安装文件夹中，并且其运行的服务器 文档根目录是不是项目的根的父。您进行开发，然后将源复制到服务器。

• 甲远程服务器是另一个计算机（远程主机）上运行的服务器。可以通过FTP / SFTP / FTPS协议访问服务器上的文件。

           通过Remote Hosts Access捆绑插件提供与服务器同步，上载，下载和管理文件，默认情况下启用该插件。如果禁用该插件，请在“设置”对话框的“ 插件”页面中将其**。有关详细信息，请参阅管理插件。请注意，该插件仅适用于IntelliJ IDEA 的Ultimate Edition。

服务器访问配置＃ 

IntelliJ IDEA通过服务器访问配置控制与Web服务器的交互。无论您何时使用服务器，都需要定义服务器访问配置，无论您的服务器是在远程主机上还是在您的计算机上。

甲服务器访问配置定义了以下内容：

• 服务器类型（就地，本地或 远程）。

• 运行服务器的计算机（主机）。对于就地和 本地服务器，IntelliJ IDEA的前提，这就是你的项目是当前计算机。

• 该服务器访问配置根：可以通过服务器配置来访问服务器层级最高的文件夹。

• 用于访问服务器配置根目录的URL地址。

• 传输数据的协议和连接参数。

• 本地文件夹（即项目根目录下的文件夹），服务器上的目标文件夹（本地或远程）和用于访问服务器上数据的URL地址之间的对应关系。这种对应关系称为映射。

  例如，您的项目存储在C：/ Projects / My_Project /下，并包含文件夹C：/ Projects / My_Project / My_Folder，而本地服务器的文档根目录在 C：/ xampp / htdocs下。您将整个项目树上传到C：/ xampp / htdocs / My_Project。在IntelliJ IDEA术语中，C：/ Projects / My_Project / My_Folder文件夹称为本地，C：/ xampp / htdocs / My_Project / My_Folder文件夹称为远程。

您可以根据需要定义任意数量的配置，从而实现上载/下载设置之间的灵活切换。

如果需要将代码部署到多个服务器，则可以创建服务器组 并避免单独部署到每个服务器。

您可以将服务器配置设置为默认值，以便IntelliJ IDEA在以下情况下以静默方式选择它：

• 自动上传已更改的文件。

• 无需选择目标主机即可 手动上载和下载文件。

• 将本地文件和文件夹与其远程版本进行比较。

• 编辑远程主机上的单个文件。

创建就地服务器配置＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

一个就地服务器是服务器，其文档根目录是项目的根的父母，无论是直接的还是不行。换句话说，Web服务器正在您的计算机上运行，​​您的项目位于其文档根目录下（例如，在/ htdocs文件夹中），您可以直接在服务器上进行开发。

要在此设置中配置对服务器的访问，您只需指定服务器文档根目录的URL地址 ，指定项目根文件夹，并指定访问它的URL地址。

指定服务器配置的名称，类型和可见性＃ 

1.  

   通过执行以下操作之一 打开“ 部署”页面：

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

   • 选择工具| 部署| 在主菜单上配置。

    

2. 在列出所有现有服务器配置的左侧窗格中，单击“ 添加” ，然后从列表中选择“ 就地 ”。

3. 在打开的“ 创建新服务器”对话框中，键入要创建的服务器的名称，然后单击“ 确定”。将关闭“ 创建新服务器”对话框，并返回 “ 部署”节点的“ 连接”选项卡。

   单击“ 用作默认值”工具栏按钮，以使IntelliJ IDEA在以下情况下以静默方式应用当前配置：

   • 自动上传已更改的文件。

   • 无需选择目标主机即可 手动上载和下载文件。

   • 将本地文件和文件夹与其远程版本进行比较。

   • 编辑远程主机上的单个文件。

4. 仅对此项目使用“ 可见”复选框以配置服务器访问配置的可见性。

   • 选中该复选框以限制将配置用于当前项目。此类配置无法在当前项目之外重复使用。它不会出现在其他项目的可用配置列表中。

      

     服务器记录与项目一起存储在.idea目录中，允许通过VCS在团队成员之间共享它们。

      

     在左侧窗格的服务器访问配置列表中，仅在当前项目中可见的配置标有图标。

   • 清除该复选框后，所有IntelliJ IDEA项目中都会显示该配置。其设置（包括SFTP服务器的SSH凭据）可以在多个项目中重复使用。

指定服务器文档根目录的URL地址＃ 

• 在“ Web服务器URL”字段中，键入与Web服务器配置文件中定义的Web服务器的文档根关联的URL地址。此URL地址将是构建应用程序URL地址的起点。

  无论是HTTP和HTTPS协议的支持。

 

例如，默认文档根目录设置为htdocs文件夹，访问其中数据的默认URL地址为http：// localhost。如果您更改了默认端口80，则必须明确指定端口： http://localhost:<port>。

 

指定项目根文件夹和URL地址以进行访问＃ 

1. 切换到Mappings选项卡。

2. 在“ 本地路径”字段中，指定项目根文件夹的完整路径。手动键入路径，或单击  并选择对话框中打开的文件夹。

3. 在Web路径字段中，键入项目根文件夹相对于服务器配置文件中指定的服务器文档根目录的路径。

 

创建本地服务器配置＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

一个本地服务器是在本地或安装文件夹中，并且其运行的服务器 文档根目录是不是项目的根的父。您进行开发，然后将源复制到服务器。

要在此设置中配置对服务器的访问，您需要指定以下内容：

1. 该服务器配置的根文件夹和URL地址来访问它。

2. 项目根文件夹，服务器上用于将数据从项目根文件夹复制到的文件夹，以及用于访问服务器上复制数据的URL地址之间的对应关系。这种对应关系称为映射。

指定服务器配置的名称，类型和可见性＃ 

1.  

   通过执行以下操作之一 打开“ 部署”页面：

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

   • 选择工具| 部署| 在主菜单上配置。

    

2. 在列出所有现有服务器配置的左侧窗格中，单击“ 添加” ，然后在弹出菜单中选择“ 本地”或“已安装文件夹 ”。

3. 在打开的“ 创建新服务器”对话框中，键入要创建的服务器的名称，然后单击“ 确定”。将关闭“ 创建新服务器”对话框，并返回“ 部署” 节点的“ 连接”选项卡 。

   单击“ 用作默认值”工具栏按钮，以使IntelliJ IDEA在以下情况下以静默方式应用当前配置：

   • 自动上传已更改的文件。

   • 无需选择目标主机即可 手动上载和下载文件。

   • 将本地文件和文件夹与其远程版本进行比较。

   • 编辑远程主机上的单个文件。

4. 仅对此项目 使用“ 可见”复选框以配置服务器访问配置的可见性。

   • 选中该复选框以限制将配置用于当前项目。此类配置无法在当前项目之外重复使用。它不会出现在其他项目的可用配置列表中。

      

     服务器记录与项目一起存储在.idea目录中，允许通过VCS在团队成员之间共享它们。

      

     在左侧窗格的服务器访问配置列表中，仅在当前项目中可见的配置标有图标。

   • 清除该复选框后，所有IntelliJ IDEA项目中都会显示该配置。其设置（包括SFTP服务器的SSH凭据）可以在多个项目中重复使用。

指定服务器配置root和访问它的URL地址＃ 

1. 切换到Mappings选项卡。

2. 在“ 文件夹”字段中，指定服务器配置根。

   该服务器配置的根是可以通过服务器配置可以访问的服务器上的文件树中最大的文件夹。最简单的方法是使用Web服务器配置文件中定义的Web服务器的文档根目录。但是，您可以在文档根目录下指定任何其他现有文件夹。

    

3. 在Web服务器URL字段中，指定服务器配置根的URL地址。此URL地址将是构建应用程序URL地址的起点。根据您选择的服务器配置root，执行以下操作之一：

   • 键入与Web服务器配置文件中定义的Web服务器的文档根关联的URL地址。

   • 以格式键入URL地址<URL of the server document root>/<path to the relevant folder relative to the server document root>。

    

   无论是HTTP和HTTPS协议的支持。

将项目文件夹映射到服务器上的文件夹以及访问它们的URL地址＃ 

配置映射，即设置项目文件夹之间的对应关系，服务器上用于复制项目文件的文件夹，以及用于访问服务器上复制数据的URL地址。最简单的方法是将整个项目根文件夹映射到服务器上的文件夹。如果已在“ 选项”对话框中选中“ 创建空目录” 复选框，则将在服务器上重复此情况下的项目文件夹结构。有关更多详细信息，请参阅配置与Web服务器的同步和自定义上载/下载。

1. 切换到Mappings选项卡。

2. 在“ 本地路径”字段中，指定所需本地文件夹的完整路径。在最简单的情况下，它是项目根。

3. 在“ 部署路径”字段中，指定服务器上IntelliJ IDEA将从“ 本地路径” 字段中指定的文件夹上载数据的文件夹。键入相对于服务器配置根目录的文件夹的路径。

   如果具有指定名称的文件夹尚不存在，则IntelliJ IDEA将创建它，前提是您已在“ 选项”对话框中选中“ 创建空目录”复选框。有关更多详细信息，请参阅自定义上载/下载。

    

4. 在“ Web路径”字段中，键入服务器上相对于服务器配置根目录的文件夹的路径。实际上，键入您在“ 部署路径”字段中键入的相对路径。

指定服务器配置root的示例＃ 

例如，服务器的默认文档根目录是 htdocs 文件夹，访问数据的默认URL地址是 http：// localhost。假设您正在使用 XAMPP 包，它安装在C：/驱动器的根目录中。

如果决定直接在服务器文档根目录下复制项目文件，则 服务器配置根目录 为C：\ xampp \ htdocs，其URL为 http：// localhost：<port>。

您可以在服务器上建立更复杂的文件夹结构，例如，在服务器文档根目录下具有 MySite1 和MySite2文件夹。在这种情况下，您必须决定在当前配置中使用哪些文件夹，将其设置为 MySite2。因此，服务器配置根目录为 C：\ xampp \ htdocs \ MySite2 ，其URL地址为http：// localhost：<port> \ MySite2。 

将项目文件夹与服务器上的文件夹映射的示例＃ 

例如，如果您的项目位于C：\ My_Projects \ Mapping_project下，则 服务器文档根目录 为C：\ xampp \ htdocs，服务器配置根目录为 C：\ xampp \ htdocs \ MySite2，其URL地址为 http：/ / localhost：<port> \ MySite2，填写如下字段：

1. 在“ 本地路径”字段中，键入C：\ My_Projects \ Mapping_project。

2. 在“ 部署路径”字段中，键入Mapping_project。

3. 在“ Web路径”字段中，键入Mapping_project。

创建远程服务器配置＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

甲远程服务器是另一个计算机（远程主机）上运行的服务器。可以通过FTP / SFTP / FTPS协议访问服务器上的文件。

要在此设置中配置对服务器的访问，您需要指定以下内容：

1. 连接设置：服务器主机，端口和用户凭据。

2. 该服务器配置的根文件夹和URL地址来访问它。

3. 项目根文件夹，服务器上用于将数据从项目根文件夹复制到的文件夹，以及用于访问服务器上复制数据的URL地址 之间的对应关系。这种对应关系称为映射。

指定服务器配置的名称，类型和可见性＃ 

1.  

   通过执行以下操作之一 打开“ 部署”页面：

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

   • 选择工具| 部署| 在主菜单上配置。

    

2. 在列出所有现有服务器配置的左侧窗格中，单击“ 添加” ，然后  根据要用于与服务器交换数据的协议选择服务器配置类型。

   • FTP：选择此选项可让IntelliJ IDEA通过FTP 文件传输协议访问服务器。

   • SFTP：选择此选项可让IntelliJ IDEA通过SFTP文件传输协议访问服务器。

   • FTPS：选择此选项可让IntelliJ IDEA通过SSL上的FTP文件传输协议（FTPS扩展）访问服务器。

3. 在打开的“ 创建新服务器”对话框中，键入要创建的服务器的名称，然后单击“ 确定”。将关闭“ 创建新服务器”对话框，并返回 “ 部署”节点的“ 连接”选项卡。

   单击“ 用作默认值”工具栏按钮，以使IntelliJ IDEA在以下情况下以静默方式应用当前配置：

   • 自动上传已更改的文件。

   • 无需选择目标主机即可 手动上载和下载文件。

   • 将本地文件和文件夹与其远程版本进行比较。

   • 编辑远程主机上的单个文件。

4. 仅对此项目 使用“ 可见”复选框以配置服务器访问配置的可见性。

   • 选中该复选框以限制将配置用于当前项目。此类配置无法在当前项目之外重复使用。它不会出现在其他项目的可用配置列表中。例如，如果在SFTP配置中选中此复选框，则无法使用其SSH凭据来配置远程解释程序。

   • 清除该复选框后，所有IntelliJ IDEA项目中都会显示该配置。其设置（包括SFTP服务器的SSH凭据）可以在多个项目中重复使用。

   有关设置解释程序的详细信息，请参阅配置Remote Node.js解释程序 和配置远程PHP解释程序 以获取详细信息。

指定在主机上注册期间定义的用户凭据＃ 

1. 指定注册模式：

   • 要以常规模式登录，请在“ 用户名”字段中指定登录名。

   • 要使用您的电子邮件地址作为密码启用对服务器的匿名访问，请选中“ 以匿名登录”复选框。

2. 指定对服务器进行身份验证的方式：

                             有关使用SSH**的详细信息，请参阅生成新的SSH**并将其添加到ssh-agent教程。 

   • 对于FTP服务器，键入密码并选择保存密码复选框以使IntelliJ IDEA记住它。

   • 对于SFTP服务器，请选择对服务器进行身份验证的方式。执行以下操作之一：

     • 密码：使用密码访问主机。指定密码，然后选择 保存密码复选框以将密码保存在IntelliJ IDEA中。

     • **对（OpenSSH或PuTTY）：使用**对的SSH身份验证。要应用此身份验证方法，您必须在客户端计算机上拥有私钥，并在远程服务器上拥有公钥。IntelliJ IDEA支持使用OpenSSH 实用程序生成的私钥。

       指定存储私钥的文件的路径，并在相应字段中键入密码（如果有）。要让IntelliJ IDEA记住密码，请选中Save passphrase复选框。

     • OpenSSH配置和身份验证代理：使用由凭据帮助应用程序管理的SSH**（例如，Windows上的Pageant或Mac和Linux上的ssh-agent）。

   • 对于FTPS服务器，请指定您的用户名和密码。在“ 高级 设置”区域中，选择要应用的安全机制。

     • 选择“ 显式” 以应用显式（活动）安全性。建立连接后，计算机上的FTP客户端立即向服务器发送命令，通过默认FTP端口建立安全控制连接。

       默认选择此方法。

     • 选择隐式 以应用隐式（被动）安全性。在这种情况下，在建立与服务器的连接时自动提供安全性，该服务器指定用于安全连接的单独端口。

       请注意，此方法被认为已弃用，因此不鼓励使用它。

启用与服务器的连接并指定服务器配置root ＃ 

1. 指定要与之交换数据的FTP / SFTP / FTPS服务器的主机名以及此服务器侦听的端口。

   默认值为：

   • 21用于FTP和FTPS

   • SFTP 22

2. 在“ 根路径”字段中，指定在注册帐户时定义的相对于用户主目录的 服务器配置根目录。此文件夹将是通过当前服务器配置可访问的文件夹结构中的最高文件夹。

   执行以下操作之一：

   • 接受默认/路径，该路径指向服务器上的用户主文件夹。

   • 手动键入路径。

   • 单击并在打开的“选择根路径”对话框中选择所需的文件夹。

   • 单击“ 自动检测”按钮，让IntelliJ IDEA检测FTP / SFTP服务器上的用户主文件夹设置，并根据它们设置根路径。只有在指定了用户名和密码后才能启用该按钮。

    

3. 在“ Web服务器URL”字段中，键入用于访问服务器配置根目录的URL地址。该服务器配置的根是在上的文件树中的*文件夹的本地或远程通过服务器配置访问的服务器。对于就地服务器，它是项目根目录。

   无论是HTTP和HTTPS协议的支持。

4. 单击 该字段以确保指定的服务器根URL地址可访问并指向正确的Web页面。

将本地文件夹映射到服务器上的文件夹以及访问它们的URL地址＃ 

配置映射，即设置项目文件夹之间的对应关系，服务器上用于复制项目文件的文件夹，以及用于访问服务器上复制数据的URL地址。最简单的方法是将整个项目根文件夹映射到服务器上的文件夹。如果已在“ 选项”对话框中选中“ 创建空目录” 复选框，则将在服务器上重复此情况下的项目文件夹结构。有关更多详细信息，请参阅配置与Web服务器的同步和自定义上载/下载。

1. 切换到Mappings选项卡。

2. 在“ 本地路径”字段中，指定所需本地文件夹的完整路径。在最简单的情况下，它是项目根。

3. 在“ 部署路径”字段中，指定服务器上IntelliJ IDEA将从“ 本地路径” 字段中指定的文件夹上载数据的文件夹。键入相对于服务器配置根目录的文件夹的路径。

   如果具有指定名称的文件夹尚不存在，则IntelliJ IDEA将创建它，前提是您已在“ 选项”对话框中选中“ 创建空目录”复选框。有关更多详细信息，请参阅自定义上载/下载。

    

4. 在“ Web路径”字段中，键入服务器上相对于服务器配置根目录的文件夹的路径。实际上，键入您在“ 部署路径”字段中键入的相对路径。

通过配置嵌套映射来重载部署目标＃ 

您可以为项目根目录下的特定文件夹配置单独的映射，以使此文件夹的内容与远程主机上的其他位置同步。

假设您已按如下方式配置映射：

本地路径	部署路径
<project_root>	FTP：//.../htdocs/my_project
<project_root> / my_folder	FTP：//.../htdocs/my_folder

然后，项目中的文件将按如下方式上传：

本地路径	部署路径
<project_root> /file1.js	FTP：//.../htdocs/my_project/file1.js
<project_root> /my_folder/file2.js	ftp：//.../htdocs/my_folder/file2.js 而不是ftp：//.../htdocs/my_project/my_folder/file2.js

 

自定义上传/下载＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

甲远程服务器是另一个计算机（远程主机）上运行的服务器。可以通过FTP / SFTP / FTPS协议访问服务器上的文件。

设置常用上传/下载选项＃ 

1. 通过执行以下操作之一打开“ 选项”对话框：

   • 在主菜单上，选择“ 工具”| 部署| 选项。

   • 在Settings / Preferences 对话框（Ctrl+Alt+S）中，转到Build，Execution，Deployment | 部署| 选项。

2. 在打开的“ 选项”对话框中，指定其他设置：

   • 要在上载/下载期间让IntelliJ IDEA跳过特定文件或整个文件夹，请在“ 按名称排除项目” 字段中，指定定义这些文件和文件夹名称的模式。

     使用分号作为分隔符。欢迎使用通配符。

     排除是递归应用的。这意味着如果匹配的文件夹具有子文件夹，则不会部署这些子文件夹的内容。

     有关从上载/下载中排除文件和文件夹的更多详细信息，请参阅从上载/下载中排除文件和文件夹。

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

为FTP / SFTP / FTPS服务器指定其他特定于协议的自定义选项＃ 

1. 通过执行以下操作之一 打开“ 部署”对话框：

   • 选择工具| 部署| 在主菜单上配置。

   • 在Settings / Preferences 对话框（Ctrl+Alt+S）中，转到Build，Execution，Deployment | 部署。

2. 在“ 部署”对话框中，展开“ 高级” 区域并指定其他上载设置：

   • 要将客户端设置为被动模式，请选中“ 被动模式”复选框。在此模式下，计算机上的客户端连接到服务器以通知处于被动模式，接收要侦听的端口号，并通过端口与接收到的号码建立数据连接。当您的计算机位于防火墙后面时，此模式很有用。

   • 要在服务器浏览器工具窗口中显示隐藏的文件和目录（名称以点开头。），请选中“ 显示并处理隐藏文件”复选框。

   • 在“ 使用列表”命令区域中选中“ 与旧版本的列出子项兼容”复选框，以确保与FTP服务器的子文件命名兼容。 

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

     Invalid descendant file name <file name>

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

      

      

   • 在“ 使用列表”命令区域中选中“ 代替MLSD”复选框，以使用标准命令列出而不是命令。这样可以避免出现问题，例如，如果FTP服务器支持并返回，则在使用无效后代文件名异常的上载期间出现故障。 LISTMLSDMLSDcdir

   • 使用“ 检索文件时间戳”列表指定MDTM FTP命令调用策略，以检索远程主机上给定文件的上次修改时间。

     可用选项包括：

     • 始终 - 选择此选项可为远程主机工具窗口中显示的每个文件调用MDTM 。

     • 在复制 - 选择此选项以在以下情况下调用MDTM：

       • 在“ 选项”对话框中的“ 覆盖最新文件”复选框 被清除时，检查文件是否是最新的。

       • 在下载期间保留文件的实际时间戳。

     • 从不 - 选择此选项以禁止调用MDTM。

      

   • 选中“ 并发连接限制”复选框，以使IntelliJ IDEA限制同时支持的连接数，并指定字段中允许的最大连接数。

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

   • 在每个发送保持活动消息字段中，指定您希望IntelliJ IDEA向服务器发送命令以重置超时的频率，从而保留连接。

   • 从Keep alive命令列表中，选择要发送到服务器的命令以重置超时，从而保留连接。

   • 在某些SFTP服务器上，可能会启用SSH横幅。每次建立连接时，都会显示带有信息消息的弹出窗口，如果要继续，则需要单击“ 确定”。

     要禁止显示信息弹出窗口，请选中忽略信息消息复选框。

从上传/下载中排除文件和文件夹＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

禁止上传，下载和同步带有源的文件或文件夹，可确保源免受意外更新。应用于非源时，它可以节省系统资源，因为不再不必要地复制媒体，缓存或临时文件。

在以下情况下，您可能需要禁止上载/下载：

1. 您将使用外部创建和上载的源代码。要在IntelliJ IDEA中处理这些远程源，您必须下载它们并将它们安排在项目中。但是，有一些消息来源根本不应该更新。另一方面，远程主机上的文件夹也可能包含您工作中实际不需要的大量媒体，缓存，临时文件。

2. 您已经从服务器下载了数据并将它们安排在IntelliJ IDEA项目中。但是，出于这个或那个原因，您需要在服务器上保留一些文件或文件夹以防止上载/下载，例如，以防止意外覆盖。

3. 应用程序的本地副本包含源代码和您不需要上载的其他数据。此外，您希望保护某些来源不被错误覆盖。在这种情况下，您可以禁止上载/下载不应上载的所有文件和文件夹。

有两种方法可以从上传/下载中排除文件夹：

• 显式地，通过在“ 远程主机” 工具窗口或 “ 部署”对话框的“ 排除路径”选项卡 中将相应路径标记为已排除 。

  1. 所有未排除的文件夹和文件的名称都显示在绿色背景上。排除项目的名称显示为无背景。

  2. 在“ 远程主机”工具窗口中，您可以排除整个文件夹和特定文件。

• 按名称，即通过指定 模式来确定 要在“ 选项” 对话框的“ 按名称排除项目”字段中 排除的文件和文件夹的名称。

只有通过名称排除文件，才能保护单独的文件不被上传/下载 。

在任何情况下，递归地应用排除。如果文件夹的路径显式标记为已排除或文件夹名称与模式匹配，则其所有子文件夹的内容（如果有）也会受到上载/下载保护。

在项目创建后从上传/下载中排除服务器上的文件夹＃ 

在“远程主机”工具窗口中选择所需的文件夹＃ 

1. 在主菜单上，选择“ 工具”| 部署| 浏览远程主机或 查看| 工具窗口| 远程主机。

2. 在打开的“ 远程主机”工具窗口中，从列表中选择相关的服务器配置。

3. 选择要排除的文件夹，然后从选择的上下文菜单中选择“ 排除路径 ”。

将所需文件夹添加到排除路径列表中＃ 

1. 通过执行以下操作之一打开“ 部署”对话框：

   • 选择工具| 部署| 在主菜单上配置。

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

2. 在“ 部署” 对话框中，切换到“ 排除的路径” 选项卡。该选项卡显示以前排除的本地和远程文件夹的列表。

3. 单击“ 添加部署路径”按钮。空行添加到列表中。

4. 点击。打开的“ 选择远程排除路径”对话框显示通过所选服务器配置访问的主机上的数据。选择所需的文件夹。

5. “ 确定”后，将返回“ 排除路径” 选项卡，其中所选远程文件夹将添加到列表中。

从上传/下载中排除本地文件夹＃ 

1. 通过执行以下操作之一打开“ 部署”对话框：

   • 选择工具| 部署| 在主菜单上配置。

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

2. 在“ 部署”对话框中，切换到“ 排除的路径”选项卡。该选项卡显示以前排除的本地和远程文件夹的列表。

3. 单击“ 添加本地路径”按钮。在添加到列表的空行中，指定要保护以免上载/下载的文件夹的位置。手动键入路径或单击 并在打开的对话框中选择所需的文件夹 。

从名称上传/下载中排除文件和文件夹＃ 

1. 通过执行以下操作之一打开“ 选项”对话框：

   • 在主菜单上，选择“ 工具”| 部署| 选项。

   • 在Settings / Preferences 对话框（Ctrl+Alt+S）中，转到Build，Execution，Deployment | 部署| 选项。

2. 在 打开的“ 选项”对话框中，在“ 按名称排除项目” 字段中指定定义这些文件和文件夹名称的模式。

   使用分号作为分隔符。欢迎使用通配符。

   排除是递归应用的。这意味着如果匹配的文件夹具有子文件夹，则不会部署这些子文件夹的内容。

删除排除标记＃ 

• 选择要上载/下载的文件或文件夹，然后 从上下文菜单中选择“ 从排除中删除路径”。

  返回上传/下载文件夹会影响其所有子文件夹和文件。

 

将服务器组织成组＃ 

通过服务器组，您可以将服务器配置组合在一起，并与单个实体一起使用它们。如果需要将代码部署到多个服务器，则可以使用服务器组并避免单独部署到每个服务器。

创建服务器组＃ 

1.  

   通过执行以下操作之一 打开“ 部署”页面：

   • 在设置/首选项 对话框（Ctrl+Alt+S），选择部署下 建立，执行，部署。

   • 选择工具| 部署| 在主菜单上配置。

    

2. 在列出所有现有服务器配置的左侧窗格中，单击“ 添加” ，然后 在弹出菜单中选择“ 服务器组 ”。

3. 在打开的“ 创建新组”对话框中，键入要创建的组的名称，然后单击“ 确定”。将关闭“ 创建新组”对话框，并返回“ 部署”节点的“ 连接”选项卡。

4. 要在组内创建新的服务器配置，请在左侧窗格中选择该组，然后单击右侧窗格中的“ 添加新服务器”链接或工具栏按钮。然后根据其类型配置新创建的服务器，如配置与Web服务器同步中所述。

   要将现有服务器配置添加到组，请将其拖到组中。要删除服务器配置，请将其拖出组。

1. 单击“ 用作默认值”工具栏按钮，以使IntelliJ IDEA在以下情况下以静默方式应用当前服务器组：

   • 自动上传已更改的文件。

   • 无需选择目标主机即可 手动上载和下载文件。

   • 编辑远程主机上的单个文件。

2. 使用“ 当前项目”复选框配置服务器组可见性，该可见性也适用于组中包含的所有服务器。

   • 选中该复选框以限制将组用于当前项目。这样的组不能在当前项目之外重用。它不会出现在其他项目的可用配置列表中。

   • 清除该复选框后，该组在所有IntelliJ IDEA项目中都可见。其设置（包括SFTP服务器的SSH凭据）可以在多个项目中重复使用。

创建的服务器组现在可用于上载和下载文件到包含的服务器。

访问Web服务器上的文件＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

一旦你已经设置同步您的本地应用程序的来源和应用程序源之间的一台服务器上，您可以创建新的文件夹，移动，重命名和删除现有的文件和文件夹。您还可以将服务器上的文件和文件夹与其本地版本进行比较。

为简单起见，IntelliJ IDEA项目中的 任何文件或文件夹都称为本地，服务器上的任何文件或文件夹都称为远程，即使服务器实际安装在您的计算机上也是如此。有关详细信息，请参阅配置与Web服务器的同步。

尽管IntelliJ IDEA支持在服务器上直接编辑单个非项目文件，但为了使本地和远程源保持同步，请使用>自动将已更改的文件上载到 “ 选项” 对话框中的默认服务器列表 来 配置自动上载。

访问服务器通过控制服务器配置 的的FTP，FTPS，SFTP，或本地或安装文件夹类型。

访问远程服务器＃ 

1. 选择 Tools | 打开 Remote Host工具窗口 部署| 浏览远程主机 或 查看| 工具窗口| 主菜单中的远程主机。

2. 从列表中选择所需的部署服务器。工具窗口显示服务器根目录下的文件和文件夹的树视图。如果列表中没有可用的相关服务器，请单击，然后在打开的“ 部署”对话框中 配置对所需服务器的访问权限。

在“ 远程主机”工具窗口中，可以右键单击文件和目录，以在服务器上创建，移动，重命名和删除文件和文件夹，以及上载和下载所需的项目。

上传和下载文件＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

上传文件和文件夹＃ 

IntelliJ IDEA提供以下主要方法将项目文件和文件夹上载到部署服务器：

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

• 自动，每次一个文件被更新，或启动调试会话之前，或者在提交给你的版本控制系统。

手动上传文件或文件夹＃ 

• 在“ 项目”工具窗口中，选择文件或文件夹，然后从上下文菜单中选择“ 上载到”，并从列表中选择目标部署服务器或服务器组。

  如果指定了默认服务器或服务器组，则还可以选择“ 上载到<默认部署服务器或服务器组>”。

如果区域已折叠，请单击  以展开它。

上传本地更改的文件＃ 

1. 切换到“ 版本控制”工具窗口（）的“ 本地更改”选项卡以查看本地更改的文件。 Alt+9

2. 选择一个文件，然后从上下文菜单中选择“ 上载到”，并从列表中选择目标部署服务器或服务器组。

   如果指定了默认服务器或服务器组组，则还可以选择“ 上载到<默认部署服务器或服务器组>”。

有关详细信息， 请参阅管理版本控制下

与VCS存储库同步后上载文件＃ 

1. 通过按Ctrl+T或选择VCS |，将本地文件的内容与VCS存储库同步 <VCS> | 从主菜单更新。

2. 切换到版本控制工具窗口的更新信息选项卡 （）。 Alt+9

3. 选择一个文件，然后从上下文菜单中选择“ 上载到”，并从列表中选择目标部署服务器或服务器组。

   如果指定了默认服务器或服务器组，则还可以选择“ 上载到<默认部署服务器或服务器组>”。

有关详情， 请参阅更新本地信息

提交后立即上传签到的文件＃ 

1. 开始检查您的更改。

2. 在“ 提交后”区域中，从“上载文件”列表中选择目标服务器或服务器组。选择一个现有配置或创建一个新配置：单击 并配置对相关服务器的访问权限，或在 打开的“ 部署”对话框中设置服务器组。

3. 要在将来自动应用选择，请选中“ 始终使用所选服务器或服务器组”复选框。

配置将已更改文件自动上载到默认服务器或服务器组＃ 

1. 通过执行以下操作之一打开“ 选项”对话框：

   • 在主菜单上，选择“ 工具”| 部署| 选项。

   • 在Settings / Preferences 对话框（Ctrl+Alt+S）中，转到Build，Execution，Deployment | 部署| 选项。

2. 从“ 自动上载已更改的文件”到“默认服务器”列表，选择希望IntelliJ IDEA上载已更改文件的时间：

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

   • 要仅上载手动保存的文件，请选择“显式保存操作”。

   • 要禁止自动上传，请选择“ 从不”。

   •    IntelliJ IDEA认为本地文件在自动或手动保存后立即更改（文件|全部保存或Ctrl+S），请参阅 使用源代码。更改的文件只能自动上载到 默认部署服务器。

下载文件和文件夹＃ 

文件和文件夹只能手动下载。

下载文件或文件夹＃ 

• 在“ 远程主机”工具窗口中，选择所需的文件或文件夹，然后 从选择的上下文菜单中选择“ 从此处下载 ”。

从默认部署服务器或服务器组下载文件＃ 

• 在主菜单上，选择“ 工具”| 部署| 从<默认服务器或服务器组>下载。

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

 

将已部署的文件和文件夹与其本地版本进行比较＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

IntelliJ IDEA项目中的文件和文件夹之间的对应关系及其在服务器上的版本是通过部署服务器映射设置的。为简单起见，IntelliJ IDEA项目中的 任何文件或文件夹都称为本地，服务器上的任何文件或文件夹都称为远程，即使服务器实际安装在您的计算机上也是如此。有关详细信息，请参阅配置与Web服务器的同步。

访问服务器＃ 

1. 选择 Tools | 打开 Remote Host工具窗口 部署| 浏览远程主机 或 查看| 工具窗口| 主菜单中的远程主机。

2. 从列表中选择所需的部署服务器。工具窗口显示服务器根目录下的文件和文件夹的树视图。如果列表中没有可用的相关服务器，请单击，然后在打开的“ 部署”对话框中 配置对所需服务器的访问权限。

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

每个远程文件或文件夹都映射到一个且只有一个本地文件或文件夹。因此，对于每个远程文件或文件夹，IntelliJ IDEA都会检测其本地版本，以便您随时进行比较。

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

1. 打开“ 远程主机”工具窗口 （“ 工具”|“部署”|“浏览远程主机”或“ 查看”|“工具Windows”|“远程主机”），然后从列表中选择所需的部署服

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

3. 在打开的“ 差异查看器文件”对话框中，浏览差异并根据需要使用按钮应用它们。有关详细信息，请参阅查看文件之间的差异。

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

1. 打开“ 远程主机”工具窗口 （“ 工具”|“部署”|“浏览远程主机”或“ 查看”|“工具Windows”|“远程主机”），然后从列表中选择所需的部署服

2. 选择文件夹，然后从选择的上下文菜单中选择“ 与本地同步 ”。

3. 在打开的文件夹差异查看器中，浏览差异并同步文件（如果适用）。请参阅差异查看器中的两个文件夹比较。

差异查看器中 的远程文件具有read-only状态。这意味着您无法在差异查看器中直接更新它们。对文件的本地版本进行所有必要的更改，并将更新的文件上载到服务器。

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

由于本地文件或文件夹可以映射到无限数量的远程对应文件，因此IntelliJ IDEA只有在通过默认部署服务器映射时才能唯一标识本地文件或文件夹的远程版本。如果未指定此类默认部署服务器，则必须手动选择相关配置。请注意，服务器组显示在服务器选择列表中仅用于一致性目的：当前，无法将本地文件与部署到服务器组的文件进行比较。

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

1. 在“ 项目”工具窗口中选择文件。

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

3. 在“ 差异查看器文件” 对话框中，打开，浏览差异并根据需要使用 按钮应用它们。有关详细信息，请参阅 查看文件之间的差异。

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

1. 在“ 项目”工具窗口中选择文件夹。

2. 从选择的上下文菜单中， 如果指定了默认服务器，请选择“ 与部署同步到<默认部署服务器>”。否则，选择“ 与部署同步到” ，然后从列表中选择相关服务器。

3. 在打开的文件夹差异查看器中，浏览差异并同步文件（如果适用）。请参阅差异查看器中的两个文件夹比较。

比较本地更改的文件与其远程版本＃ 

1. 切换到“ 版本控制”工具窗口（）的“ 本地更改”选项卡以查看本地更改的文件。 Alt+9

2. 选择一个文件，然后从上下文菜单中选择Compare with Deployed to，并从列表中选择目标部署服务器。

   如果指定了默认服务器组，则还可以选择“ 与部署比较”到“默认部署服务器”。

有关详细信息， 请参阅管理版本控制下

将与VCS存储库同步的文件与其远程版本进行比较＃ 

1. 通过按Ctrl+T或选择VCS |，将本地文件的内容与VCS存储库同步 <VCS> | 从主菜单更新。

2. 切换到版本控制工具窗口的更新信息选项卡 （）。 Alt+9

3. 选择一个文件，然后从上下文菜单中选择Compare with Deployed to，并从列表中选择目标部署服务器。

   如果指定了默认服务器，您还可以选择“ 与部署比较”到“默认部署服务器”。

有关详情， 请参阅更新本地信息

差异查看器中 的远程文件具有read-only状态。这意味着您无法在差异查看器中直接更新它们。对文件的本地版本进行所有必要的更改，并将更新的文件上载到服务器。

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

IntelliJ IDEA 为文件夹提供专用的差异查看器， 用于将远程文件夹及其本地版本中的文件与文件大小，内容或时间戳进行比较。除了探索差异之外，该工具还提供了用于同步文件夹内容的界面。

• 该项目列表显示了本地和远程文件夹的内容。使用工具栏按钮缩小或加宽要显示的项目集。例如，显示或隐藏仅本地或远程存在的文件，相同文件，不同文件，从同步中排除的文件等。

• 远程文件夹的内容始终显示在右侧窗格中，其本地版本的内容始终显示在左侧窗格中。

• 所选文件的内容显示在下部窗格中，差异以颜色突出显示。差异查看器中的远程文件具有read-only状态。这意味着您无法在差异查看器中直接更新它们。对文件的本地版本进行所有必要的更改，并将更新的文件上载到服务器。

 

比较两个文件夹＃ 

1. 指定要进行比较的参数。在“ 比较依据”列表中，选择一个可能的选项（内容，大小或时间戳）。

2. 过滤文件夹的内容。为此，请在“ 过滤器”字段中键入过滤字符串 ，然后按Enter将其应用。欢迎使用星号*通配符表示任意数量的字符。

3. 要切换到另一对要比较的文件夹，请更新它们的完全限定路径。单击“ 路径”只读字段旁边的， 然后在打开的对话框中选择所需的文件夹 。

4. 探索差异窗格中检测到的文件之间的差异。

   

    

同步两个文件夹的内容＃ 

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

   •  文件将被上传，可能会覆盖远程版本。

   •  该文件将被下载，可能会覆盖本地版本。

   •  对于所选择的比较标准，文件被视为相同。默认情况下不会执行任何操作。

   •  文件在所选择的比较标准方面有所不同。默认情况下不会执行任何操作。探索差异查看器的 差异窗格 中的差异，并通过单击图标更改预期的操作。

   •  该文件仅在本地或远程存在，将被删除。

2. 执行以下操作之一：

   • 要同步当前选定的项目，请单击 工具栏上的“ 同步所选项” 按钮 。

   • 要同步所有项目，请单击 工具栏上的“ 全部同步”按钮 。

编辑远程主机上的单个文件＃ 

此页面和整个“使用Web服务器：复制文件”一章中描述的功能仅在IntelliJ IDEA 的Ultimate Edition中提供。

一旦你设置同步 与远程主机，可以从远程主机直接打开单个文件和IntelliJ IDEA的编辑，不用添加/它们下载到本地项目。请注意，对于未包含在项目中的此类文件，不支持某些IntelliJ IDEA功能。

要利用调试，重构和其他高级功能，请考虑将文件包含到项目中; 有关详细信息， 请参阅访问Web服务器上的文件

文件

编辑远程主机上的文件＃ 

1. 如果已设置默认远程主机，请选择“ 部署”| 从“ 项目工具”窗口，“ 版本控制工具窗口 ”或代码编辑器的上下文菜单中编辑“远程文件”。

   否则，请执行以下操作：

   • 选择 Tools | 打开 Remote Host工具窗口 部署| 浏览远程主机 或 查看| 工具窗口| 主菜单中的远程主机。

   • 从列表中选择所需的部署服务器。工具窗口显示服务器根目录下的文件和文件夹的树视图。如果列表中没有可用的相关服务器，请单击，然后在打开的“ 部署”对话框中 配置对所需服务器的访问权限。

   • 双击所需文件或从上下文菜单中选择“ 编辑远程文件 ”。

     

2. 该文件在IntelliJ IDEA编辑器中打开，无需添加或下载到本地项目。

    

   

   使用远程文件时，编辑器顶部会出现一个特殊工具栏，显示编辑状态（该文件与远程文件相同 或文件已被修改。上传？）。

   可以通过包含服务器名称的注释（在我们的示例中为<MyServer>）将远程文件与本地文件区分开来。

   

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

   • 要将文件上载到远程主机，请单击或按 Shift+Alt+Q。

   • 要将当前打开的文件与上次上载的版本进行比较，请单击 。这些文件在IntelliJ IDEA 差异查看器中打开以供文件使用。

   • 要丢弃上次上载后引入文件的更改，请单击。

请注意，单个文件未添加到项目中。因此，只要关闭文件或当前打开的项目，除非已上载这些更改，否则将丢弃所有更改。为防止丢失数据，当您尝试关闭已编辑的文件或整个项目时，IntelliJ IDEA会显示以下对话框。

 

运行SSH终端＃ 

此功能仅在Ultimate版本中受支持。

您可以直接从IntelliJ IDEA 启动SSH会话。通过在专用SSH终端中运行命令，您可以通过SSH隧道访问远程Web服务器或Vagrant实例（虚拟机）上的数据，主要是上载和下载文件。

准备在SSH终端中工作＃ 

1. 确保已启用SSH Remote Run插件。该插件默认**。如果插件已禁用，请在“ 插件”页面上启用它，如管理插件中所述。

2. 确保目标环境中有SSH服务器：远程Web服务器或Vagrant实例（虚拟机）。

3. 在目标环境中的SSH服务器上注册帐户，并生成一对SSH**或密码，具体取决于服务器策略。

4. 指定目标环境并指定与其建立连接的设置：

   1. 按或选择文件| 打开设置/首选项对话框 设置 Windows和Linux或 IntelliJ IDEA的| macOS的首选项，然后单击“ 工具”下的“ SSH终端 ” 。该 SSH终端 打开页面。 Ctrl+Alt+S

   2. 在“ 连接设置”区域中，指定 目标环境：

      • 当前Vagrant：选择此选项可在当前运行的Vagrant虚拟机上执行SSH终端中的命令。有关详细信息，请参阅Vagrant。

      • 部署服务器：选择此选项可使本地或远程Web服务器上执行的SSH终端中的命令可通过其中一个服务器访问配置访问。从下拉列表中，选择指定目标环境的服务器访问配置以及与其建立连接的设置。

        • 每次运行时选择服务器：如果选择此选项，则每次选择“ 工具”|“工具”时，都必须从弹出窗口中选择所需的服务器访问配置。在主菜单上启动SSH会话。

        • 如果所需的服务器访问配置未显示在下拉列表中，请单击“ 配置服务器 ”链接 ，然后在“ 部署”页面中定义一个。有关详细信息，请参阅配置与远程主机同步部分。

   3. 从“ 默认编码”下拉列表中，选择要在SSH终端中使用的所需编码。

启动SSH终端＃ 

1. 在主菜单上，选择“ 工具”| 启动SSH会话。或者，调用帮助| 找到Action（Ctrl+Shift+A）对话框，搜索start ssh ..，然后选择Start SSH Session。

2. 取决于工具|中定义的连接设置 IntelliJ IDEA设置（Ctrl+Alt+S）的SSH终端页面，可能存在以下类型的行为：

   • 如果选择了Current Vagrant选项，则SSH终端将提供对当前运行的Vagrant虚拟机的访问。有关详细信息，请参阅 Vagrant。

   • 如果选择了“ 部署服务器 ”选项，则SSH终端将控制可通过 从列表中选择的服务器访问配置访问的本地或远程Web服务器上的数据 。有关详细信息，请参阅 配置与Web服务器的同步。

   • 如果选择了每次运行时选择服务器选项，IntelliJ IDEA将显示一个列表，以从中选择所需的服务器访问配置。

 

使用文件监视器＃ 

此功能仅在Ultimate版本中受支持。

File Watcher是一个内置的IntelliJ IDEA工具，允许您在IDE中更改或保存文件时自动运行命令行工具，如编译器，格式化程序或短接程序。

您可以从头开始配置文件监视器或使用其中一个可用模板。Configured File Watcher可以保存在项目设置或IDE设置中，并在不同的项目中使用。

在开始之前，在上安装文件看守插件插件的描述页面管理插件。

创建文件监视器＃ 

1. 在“ 设置/首选项” 对话框（Ctrl+Alt+S）中，单击“ 工具”下的“ 文件监视器 ” 。将打开“ 文件监视器”页面，其中显示已在此项目和IDE中配置的文件监视器列表。

2. 单击并选择要从中创建文件监视器的预定义模板。选择取决于您要使用的工具。要使用列表中没有的工具，请选择“ 自定义”。将打开“ 新建观察器”对话框。

3. 在“ 名称”文本框中，键入文件观察程序的名称。默认情况下，IntelliJ IDEA会建议所选预定义模板的名称。

配置输入文件的预期类型和位置＃ 

使用“要监视的文件”区域中的控件来定义要应用文件监视器的文件范围。

1. 从“ 文件类型”下拉列表中，选择所需的输入文件类型。文件观察程序将仅考虑此类型的文件作为分析和处理的主题。基于文件类型和文件扩展名之间的关联来识别 文件类型。

2. 选择范围，并且该文件Watcher是适用的。这些文件中的更改将立即或在保存或帧停用时调用文件观察器，具体取决于自动保存编辑文件的状态以触发观察器复选框。

   从列表中选择一个预定义范围。对于项目级文件监视器，您还可以单击以在打开的“ 作用域”对话框中配置自定义作用域。

   • 所有地方：下面列出的所有范围。

   • 项目文件：项目内容根目录中的所有文件（请参阅内容根目录 ）。

   • 项目生产文件：项目内容根目录中的所有文件，不包括测试源。

   • 项目测试文件：项目测试源根目录中的所有文件。

   • Scratches and Consoles：Scratches and Consoles目录中位于Project工具窗口中的 所有文件。

   • 打开文件：当前在编辑器中打开的所有文件。

   • 当前文件：在活动编辑器选项卡中打开的文件。

   VCS范围：仅当您的项目受版本控制时，这些范围才可用。

   • 更改的文件：所有已更改的文件，即与所有现有更改列表关联的所有文件。

   • 默认更改列表：与更改列表关联的所有文件  Default。

   或者，在打开的“ 范围”对话框中单击并配置自定义范围。

    

3. （可选）：指定文件管理器如何处理依赖项。甲根文件是不包含文件（例如通过import在任何其他文件） 在规定范围内。

   • 要仅针对根文件运行文件监视器，请选中“ 仅跟踪根文件”复选框。

   • 清除该复选框以针对调用它的文件运行文件观察器，并针对该文件以递归方式包含在指定范围内的所有文件。

   请注意，“ 范围”设置将覆盖“ 仅跟踪根文件”复选框设置：如果依赖关系超出指定范围，则不会对文件监视器应用“文件监视器”。

配置与外部工具的交互＃ 

在“ 要在更改区域上运行的工具”中，指定要使用的工具，传递给它的参数，预期的输出文件类型等。

1. 在“ 程序”文本框中，指定工具的可执行文件的路径（.exe，.cmd，.bat或其他，具体取决于特定工具）。

   如果要为项目中安装的工具（例如Prettier）配置全局文件监视器，则需要使用宏指定其路径。要使用路径中的某个可用宏，请按“ 插入宏”按钮。例如，使用$ ProjectFileDir $ / node_modules / .bin / prettier路径，文件监视器将在项目的node_module文件夹中使用更漂亮的文件。

2. 在“ 参数”文本框中，定义要传递给工具的参数。例如，通常使用宏来指定参数，$FileName$或者$FileNameWithoutExtension$将使用实际文件名替换参数。
   手动键入宏或单击“ 插入宏”，然后从打开的“ 宏”对话框中的列表中选择相关模式。

3. 在“ 要刷新的输出路径”文本框中，指定工具存储其输出的文件：生成的源代码，源映射和依赖项。基于这些设置，IntelliJ IDEA可识别通过编译生成的文件。

   请注意，将输出路径中的值更改为刷新字段不会使工具将其输出存储在其他位置。如果仍需要这样做，请在“ 参数”字段中指定所需的自定义输出位置：键入以冒号作为分隔符的输出路径并使用宏。

   通常使用宏指定输出路径。手动键入路径o单击“ 插入宏”， 然后从列表中选择相关模式。

4. 展开工作目录和环境变量隐藏区域。

5. 定义环境变量。例如，PATH为启动正在配置的工具所需的工具指定变量，但在路径中未引用该工具。在大多数情况下，它是Node.js或ruby.exe。这种情况可能来自自定义手动安装，而不是通过Node Package Manager（npm）或gem manager进行安装。

6. 在“ 工作目录”文本框中，指定要将工具应用到的目录。
   由于始终在文件上下文中调用该工具，因此默认工作目录是当前文件的目录。通过$FileDir$宏在所有预定义模板中指定默认工作目录。要指定自定义工作目录，请在字段中键入自定义工作目录，或在“ 选择路径”对话框中单击 并选择目录，或单击“ 插入宏”，然后 从“ 宏”对话框的列表中选择所需的宏。

配置高级选项＃ 

在“ 高级选项”区域中，自定义“文件观察程序”的默认行为。

1. 指定将调用File Watcher的事件：

   • 要在对源代码进行任何更改后立即调用文件观察器，请选择自动保存已编辑的文件以触发观察器复选框。
     清除该复选框后，File Watcher将在保存（文件|全部保存）或从IntelliJ IDEA移动焦点时启动（在帧停用时）。

   • 默认情况下，文件观察程序会唤醒任何已保存的更改，包括在您（例如，签出分支）时从版本控制系统收到的更新。要忽略此类更改并仅调用文件观察器，请在IntelliJ IDEA中更新代码，清除“ 在外部更改上触发观察器”复选框。

2. 指定是否希望文件观察程序与IntelliJ IDEA语法分析程序交互：

   • 当选择Trigger观察器而不考虑语法错误复选框时，无论文件的语法正确性如何，文件观察器都会启动。File Watcher将在更新，保存或帧停用时启动，具体取决于自动保存编辑文件的状态以触发观察器复选框。

   • 当清除Trigger观察器而不管语法错误复选框时，文件监视器会忽略语法无效的文件中的所有触发器，并且仅在无错误文件中启动。

3. 使用stdout中的Create output file复选框指定生成输出文件的方式。

   • 选中该复选框后，IntelliJ IDEA将读取本机工具的output（standard output stream (stdout)）并从中生成结果文件。

   • 清除该复选框后，该工具会将其输出直接写入“ 输出路径刷新”字段中指定的文件。

4. 在“ 显示控制台”下拉列表中，选择希望文件观察程序打开控制台的时间。

   • 始终：使用此选项，控制台始终在工具执行完成后打开。

   • 出错：使用此选项，控制台仅在Exit code不同时才会在工具执行后打开0。

   • 从不：选择此选项可以完全禁止打开控制台。

显示File Watcher在编辑器中报告的信息＃ 

如果文件监视器中配置的工具通过指向文件和特定行的链接报告有关代码的错误或警告，则可以在编辑器中直接看到此信息：

• 在首选项/设置中| 编辑| 检查，启用检查文件观察器问题。

• 在“ 编辑观察器”对话框的“ 输出过滤器”字段中，描述要匹配的输出的格式。使用宏，以及为。您需要避免使用大括号和点等特殊符号。与宏匹配的文本将显示在编辑器中。$FILE_PATH$$LINE$$MESSAGE$\$MESSAGE$

例：

该工具按以下格式报告错误：

 

ERROR: /Users/Alice/WebstormProjects/angular-app/src/main.ts[6, 27]: " should be '

使用以下正则表达式作为输出过滤器，以查看编辑器中突出显示的错误：

ERROR: $FILE_PATH$\[$LINE$, $COLUMN$\]: $MESSAGE$

 

保存，启用和禁用文件监视器＃ 

保存新的文件监视器后，您可以决定它是仅在当前项目中可用（在右栏中选择项目）还是在所有项目中选择（选择全局）。

要启用或禁用文件监视器，请在“首选项/设置”中选择或清除它旁边的复选框 工具| 文件监视器对话框。

要切换文件观察器的启用/禁用状态，请在“设置”对话框的“ 文件监视器”页面上选中/清除它旁边的复选框。如果在文件观察程序运行时发生错误，则会自动禁用文件监视器。要恢复状态，请手动启用文件监视器。

启用文件观察程序后，只要更改或保存所选类型和所选范围的文件，它就会自动启动，请参阅配置高级选项。

在File Watcher中自定义外部工具行为的示例＃ 

影响第三方工具的唯一方法是将参数传递给它，就像在命令行模式下工作一样。这些参数特定于每个工具。下面是两个自定义CoffeeScript编译器的默认输出位置的示例。

假设您有一个具有以下文件夹结构的项目：

默认情况下，生成的文件将存储在原始文件所在的文件夹中。您可以更改此默认位置，并将生成的文件存储在.js文件夹中。此外，您可以将它们存储在平面列表中或排列在文件夹结构中，以重复app节点下的原始结构。

 

将所有生成的文件存储在输出js文件夹中＃ 

1. 在“ 参数”字段中，键入：

   
   --output $ProjectFileDir$\js\$FileDirRelativeToProjectRoot$\ --compile --map $FileName$
                       

    

2. 在“ 要刷新的输出路径”字段中，键入：

   
   $ProjectFileDir$\js\$FileDirRelativeToProjectRoot$\$FileNameWithoutExtension$.js:$ProjectFileDir$\js\$FileDirRelativeToProjectRoot$\$FileNameWithoutExtension$.map
                       

   因此，项目树如下所示：

   

    

文件监视器故障排除＃ 

“首选项/设置”列表中的“文件观察器”旁边可能有红色错误消息 工具| 文件监视器。

以下是可能的错误列表：

报告的问题	问题描述	解决方法
Unknown Scope error	文件观察程序使用未在此项目中定义的范围。	双击观察程序并选择可用范围或创建新范围。
Not found error	该项目使用已删除的全局文件监视器。	使用“ 删除”按钮（）从列表中删除观察者，或者对其进行编辑以创建具有相同名称的新全局观察者。