IntelliJ IDEA弹出“Untrusted Project”警告，如何安全解除并恢复正常开发？

Question

IntelliJ IDEA 自 2021.3 版本起引入「Untrusted Project」安全机制：当项目来自外部（如 Git 克隆、下载解压、网络共享路径等），IDE 默认禁用脚本执行、自动构建、插件运行及宏操作，防止恶意代码静默执行。此时编辑器顶部显示黄色警告条，部分功能灰显（如 Run/Debug 按钮不可用、Maven 自动导入失效）。**安全解除的关键不是“跳过验证”，而是主动建立信任**：点击警告条右侧「Trust Project」→ 选择「Trust Project for This Session」（临时）或「Trust Project and Remember My Choice」（永久，仅限本地可信路径）。首次信任前建议核查项目来源、检查 `.idea/` 下可疑配置、扫描 `pom.xml`/`build.gradle` 中的远程脚本或插件。切勿对陌生 GitHub 项目直接点「Trust Always」。信任后重启相关服务（如 Build Tools、Annotation Processors）即可恢复正常开发。该机制可于 Settings → Advanced Settings → “Allow scripts to run in untrusted projects” 手动关闭（不推荐）。

Answer 1

```html

一、现象层：识别「Untrusted Project」的典型表征

当你在 IntelliJ IDEA 2021.3+ 中打开一个通过 git clone、ZIP 解压、SMB/NFS 共享挂载或浏览器下载的 Java/Kotlin 项目时，编辑器顶部将立即出现一条醒目的黄色横幅：

• 文字提示：“This project is untrusted. Some features have been disabled.”
• UI 表现：Run/Debug 按钮灰显不可点击；Maven 工具窗口中“Auto-import”开关强制关闭；Gradle tasks 列表为空；Lombok 注解处理器不生效；Live Templates 和宏（Macro）执行被拦截。
• 日志佐证：IDEA 日志（Help → Show Log in Explorer）中可见 Project trust state changed to UNTRUSTED 记录。

二、机制层：安全模型设计原理与信任边界

该机制基于「默认拒绝（Default-Deny）」原则构建，其核心组件包括：

信任维度	受限行为	底层拦截点
脚本执行	Shell/Bash/Python 脚本（如 Maven <exec> 插件、Gradle exec {}）	ProcessHandlerWrapper + SecurityManager 策略注入
构建自动化	Maven auto-import, Gradle auto-sync, Annotation Processor 启用	BuildManagerImpl#isProjectTrusted() 校验链

三、验证层：信任建立前的必检清单（DevSecOps 实践）

在点击「Trust Project」前，资深开发者应执行以下深度核查：

1. 来源溯源：检查 git log --oneline -n 5 是否含可疑 commit（如大量 binary blob、非标准 author）；确认 GitHub 仓库是否为官方组织（非 fork 或高仿账号）
2. 配置审计：审查 .idea/misc.xml 中是否存在 <option name="enableScriptExecution" value="true"/> 强制覆盖项
3. 构建脚本扫描：运行 grep -r "exec\|sh\|bash\|curl\|wget" pom.xml build.gradle* --include="*.xml" --include="*.gradle"

四、操作层：信任策略选择与工程影响对比

两种信任模式对团队协作与 CI/CD 流水线存在实质性差异：

graph LR A[点击 Trust Project] --> B{选择策略} B --> C[Trust for This Session] B --> D[Trust and Remember My Choice] C --> E[重启 IDE 后失效
适合 PoC/临时调试] D --> F[写入 ~/.IntelliJIdea*/config/options/trustedProjects.xml
仅对本地绝对路径生效]

五、治理层：企业级统一管控方案

大型组织可通过以下方式实现规模化治理：

• 策略即代码：在 idea.properties 中预置 idea.trusted.project.paths=/opt/company/projects/*,/home/dev/internal/*
• IDE 镜像固化：Dockerfile 中注入 RUN echo 'idea.trusted.project.paths=/workspace/*' >> /opt/idea/bin/idea.properties
• Git 钩子防护：pre-commit 检查 .idea/ 目录是否包含未签名的 workspace.xml 修改

六、规避层：禁用机制的风险评估与适用场景

Settings → Advanced Settings → “Allow scripts to run in untrusted projects” 开关虽存在，但仅建议用于以下隔离环境：

• 离线沙箱环境（无网络、无外设、无共享文件系统）
• CI 构建 Agent 容器（通过 --read-only 挂载 + seccomp 限制 syscall）
• 遗留系统迁移过渡期（需同步启动 SonarQube SAST 扫描流水线）

七、演进层：从 IDEA 2021.3 到 2024.x 的信任模型增强

后续版本持续强化该机制：

• 2022.3：引入 trustedProjects.xml 的 SHA-256 路径哈希校验，防路径劫持
• 2023.2：支持 Git 子模块递归信任继承（需显式启用 git.submodule.trust.inheritance）
• 2024.1：与 JetBrains Gateway 集成，远程开发会话自动同步信任状态至服务端

```