配置 PyCharm 设置

为了防止潜在的安全风险,如果您不确定项目的来源,PyCharm 允许您决定如何打开项目。PyCharm 会警告您在打开过程中将执行的任务或配置,并让您配置您可以信任的来源。

打开未知来源的项目

当您打开一个项目(例如 Gradle 或 Maven)时,PyCharm 会在加载过程中执行其构建脚本。这些构建脚本可以包含任意(潜在危险)代码。

当您打开任何项目时,PyCharm 会立即让您决定如何处理包含不熟悉源代码的项目。

信任项目对话框

您可以选择以下操作之一:

  • 在安全模式下预览:在这种情况下,PyCharm 以“预览模式”打开项目,这意味着您可以浏览项目的源代码,但在执行代码、执行任何与构建相关的活动或运行任何脚本方面存在限制。

    有关安全模式预览限制的更多信息,请参阅安全模式预览限制

    PyCharm 在编辑器区域顶部显示一条通知,您可以单击Trust project链接并随时加载您的项目。

  • 信任项目:在这种情况下,PyCharm 打开并加载一个项目。这意味着项目已初始化,项目的插件已解决,依赖项已添加,并且所有 PyCharm 功能都可用。

  • 不要打开:在这种情况下,PyCharm 会取消操作。

首次打开项目

当您第一次尝试从未知来源打开 Gradle 或 Maven 项目时,PyCharm 会显示警告并让您决定如何继续。

您可以选择以下操作之一:

  • 在安全模式下预览:在这种情况下,PyCharm 以“预览模式”打开项目,这意味着您可以浏览项目的源代码,但执行任何任务或目标、构建或运行项目可能是不安全的。

    PyCharm 在编辑器区域顶部显示一条通知,您可以单击Trust project链接并随时加载您的项目。

  • 信任项目:在这种情况下,PyCharm 会正常打开并加载项目。这意味着构建脚本被执行,项目的插件被解析,依赖被添加等等。

  • 不要打开:在这种情况下,PyCharm 会取消操作。

打开现有项目

如果您计划打开的项目是在另一台机器上创建的并且包含.idea目录,PyCharm 会自动在 IDE 中打开它,就像您选择了“在安全模式下预览”操作一样。PyCharm 不执行构建脚本、解析项目的插件或添加任何依赖项。但是,您仍然可以浏览项目的源代码并在编辑器中打开它们。

如果您尝试通过其专用工具窗口或Run Anything窗口执行任何 Maven 目标或 Gradle 任务,PyCharm 将显示一条通知,建议您在执行任何操作之前信任并加载项目。

PyCharm 还会显示一个编辑器通知,说明该项目不受信任。

如果您信任源,请单击信任项目并加载它。

在这种情况下,PyCharm 会加载项目、解析插件、添加必要的依赖项等等。

您还可以将源添加到受信任的位置,这样下次打开项目时,PyCharm 将隐式信任它。

启动任务

当您打开在不同机器上创建的项目时,它可能包含一些在打开过程中执行的脚本或任务。如果找到此类任务,PyCharm 会显示一条通知,提示您即将执行的代码可能有害。

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

查看启动任务

  1. 设置/首选项对话框 ( Ctrl+Alt+S) 中,转到工具 | 启动任务

  2. 启动任务设置页面,您可以查看和修改启动任务

安全模式预览限制

如果您在安全模式下打开项目,以下限制将适用于该项目:

  • :在打开过程中执行的任何脚本或任务都被禁用。

  • VCS支持:整个 VCS 支持被禁用。

  • GDSL 脚本:不会执行任何 Groovy DSL 脚本。

  • File Watchers脚本不会被执行。

受信任的位置

您可以配置 PyCharm 应该认为安全的源并在打开过程中自动加载此类项目。

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

配置受信任的位置

  1. Settings/Preferences对话框 ( Ctrl+Alt+S) 中,转到Build、Execution、Deployment | 受信任的位置

  2. Trusted Locations设置页面上,配置您认为受信任的项目所在的本地目录。单击确定以保存更改。

    受信任的位置

    下次您从这些位置之一打开项目时,PyCharm 将自动加载该项目。

最后修改:2022 年 1 月 17 日