# 项目安全性

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

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

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

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

当您打开一个 [CMake](quick-cmake-tutorial.html)、 [Makefile](makefiles-support.html)或 [Gradle](gradle-support.html)项目时，CLion 会在加载过程中执行其构建脚本。 这些构建脚本可能包含任意（潜在危险的）代码。

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

项目:

![信任项目对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_trust_cmake_prj_dialog.png)

* 安全模式中预览 ：在这种情况下，CLion 会在 安全模式 中打开项目，这意味着您可以浏览项目的源代码，但在执行代码、进行构建相关活动以及运行脚本（例如，执行 Gradle 任务、加载和运行 CMake 或 Makefile 目标）方面会受到限制。 > **Tip:** > 如果您停留在 安全模式 ，CLion 将不会为项目中其他潜在危险功能显示额外通知。 例如， [启动任务](#startup_tasks)将被静默跳过。 如需了解更多信息，请参阅 [安全模式预览限制](#safe_mode_limitations)。 CLion 在编辑器区域顶部通知您 安全模式 。 ![cl_trust_cmake_editor_notification.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_trust_cmake_editor_notification.png) 如果您尝试重新加载项目或在 CMake 或 Makefile 的情况下执行目标，或者使用菜单项、专用工具窗口或 运行任意内容 窗口运行 Gradle 任务，CLion 会提示您在继续之前确认您信任该项目： ![cl_trust_cmake_load.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_trust_cmake_load.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` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 打开搜索窗口，然后输入 信任项目 。

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

* 请勿打开 ：在这种情况下，CLion 取消了该操作。

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

## 启动任务

当您打开在其他机器上创建的项目时，它可能包含一些在打开过程中执行的脚本或任务。 如果发现此类任务，CLion 会显示通知，提示您即将执行的代码可能有害。

您可以查看将要执行的任务并修改设置。

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，前往  `工具 | 启动任务` 。

2. 在   启动任务   设置页面，您可以查看并修改 [启动任务](settings-tools-startup-tasks.html)。

## 安全模式预览限制

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

* [启动任务](#startup_tasks)：开始过程中执行的任何脚本或任务都被禁用。

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

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

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

## 受信任位置

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

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

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

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，前往  `外观＆行为 | 受信任位置` 。

2. 在   受信位置  设置页面上，指定 IDE 应该信任的本地目录。 请点击   确定   以保存更改。

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

您下次从这些位置之一打开 项目 时，CLion 将会隐式信任它。

