# 项目安全

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

为防止潜在的安全风险，IntelliJ IDEA 让您在不确定项目或文件来源时决定如何打开它。 IntelliJ IDEA 会在启动过程中告知您将要执行的任务或配置，并且让您配置可以信任的来源。

> **Note:**
> 您可以配置 [受信任位置](#trust_sources)，以自动加载来自特定目录的项目。

## 打开来自未知来源的项目或文件

打开任何项目或文件时，IntelliJ IDEA 会立即让您决定如何处理包含不熟悉源代码的项目或文件。

首次打开项目或文件时，IDE 会显示   信任   对话框。 这有助于确保项目或文件可以安全地执行以下操作：

项目:

![不受信任的项目](https://resources.jetbrains.com/help/img/idea/2026.3/untrusted_project_first_open.png)

* 在安全模式中预览 ：在这种情况下，IntelliJ IDEA 会在 安全模式 中打开项目，这意味着您可以浏览项目的源代码，但在执行代码、执行构建相关活动和运行脚本方面会受到限制。 有关安全模式预览限制的更多信息，请参阅 [安全模式预览限制](#safe_mode_limitations)。 IntelliJ IDEA 在编辑器区域顶部通知您 安全模式 。 ![信任项目通知](https://resources.jetbrains.com/help/img/idea/2026.3/editor_notification.png) 如果此时您想信任某个项目，请点击 信任项目… 链接并加载您的项目。 或者，在主菜单中，转到 `导航 | 全局搜索` ，或按两次 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 打开搜索窗口，然后输入 信任项目 。

* 信任项目 ：在这种情况下，IntelliJ IDEA 打开并初始化项目，解析项目插件，添加依赖项，并启用所有 IntelliJ IDEA 功能。

* 不打开 ：在这种情况下，IntelliJ IDEA 取消了该操作。

> **Note:**
> 要信任您尝试从中打开项目的目录，请选择   信任 <b>'<path>'</b> 文件夹中的所有项目。   复选框。 下次从该目录打开项目时，它将自动打开并加载。
>
>
>
> 在 Windows 上，可使用   将 IDE 'project...' 文件夹添加到 Microsoft Defender 排除项列表   选项。 您可以使用它将某些项目目录排除在扫描之外，这可能会提高 IDE 的性能。

文件:

![信任文件](https://resources.jetbrains.com/help/img/idea/2026.3/trust_file.png)

* 保持在保存模式 ：在这种情况下，IntelliJ IDEA 会以安全模式打开文件，这意味着您可以浏览文件内容，但在执行代码、执行构建相关活动和运行脚本方面会受到限制。 有关安全模式预览限制的更多信息，请参阅 [安全模式限制](#safe_mode_limitations)。

* 信任文件 ：在这种情况下，IntelliJ IDEA 会打开文件，启用所有 IntelliJ IDEA 功能，并允许执行所有可用操作。

## 安全模式预览限制

如果您在   安全模式   中打开一个项目，将会有以下限制：

* 对于包含任何构建工具的项目， [Gradle](work-with-gradle-projects.html#gradle_refresh_project)、 [Maven](delegate-build-and-run-actions-to-maven.html#maven_reimport) 或 [sbt](sbt-support.html#manage_sbt_projects) 导入已被禁用。 因此，不会执行构建脚本，也不会解析依赖项。

* [启动任务](settings-tools-startup-tasks.html)：开始过程中执行的任何脚本或任务都被禁用。

* [VCS support](version-control-integration.html)：VCS support 已完全禁用。

* GDSL 脚本：任何 Groovy DSL 脚本都不会被执行。

* [File Watcher](using-file-watchers.html) 脚本将不会唤醒并运行相应的工具。

* [数据库工具和 SQL](relational-databases.html)：数据库连接已禁用。

## 受信任的位置

您可以配置 IntelliJ IDEA 应该认为安全的资源，并在打开过程中自动加载这些项目。

您可以将主目录添加到受信任的位置，以禁用 IntelliJ IDEA 关于不受信任项目的警告。

> **Warning:**
> 使用命令行启动器以无头模式启动 IntelliJ IDEA 实例时，项目默认以受信任模式打开。

Procedure: 配置受信任的位置

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. 在   受信位置  设置页面上，指定 IDE 应该信任的本地目录。 点击   OK   保存更改。

![受信位置](https://resources.jetbrains.com/help/img/idea/2026.3/trusted_locations.png)

您下次从这些位置之一打开 project 时，IntelliJ IDEA 将会隐式信任它。