CMD 开启局部变量和延迟扩展

setlocal enabledelayedexpansion 是 Windows 批处理（Batch/CMD）脚本中极其重要且非常常见的一句命令。

它可以拆解为两个部分来理解：限定变量作用域 和 开启延迟扩展。

1. setlocal（开启局部变量）

默认情况下，在 cmd 中设置的变量（使用 set 命令）是全局的。如果你在一个脚本里修改了系统变量，脚本运行结束后，这个修改依然生效，这可能会污染系统的环境变量。

• setlocal 的作用是告诉系统：“从这行代码开始，所有对环境变量的修改都是局部的。”
• 当脚本执行结束，或者遇到 endlocal 命令时，所有的变量都会恢复到 setlocal 执行之前的状态。

2. enabledelayedexpansion（开启延迟扩展）

这是这句命令的核心所在。为了理解它，我们需要先了解 CMD 脚本的“预处理机制（解析机制）”。

痛点：默认的“预处理”机制

在默认情况下，CMD 读取脚本时，是一块一块（Block）读取的。一段被括号 () 包围的代码（比如 if 语句块或 for 循环）被视为一个整块。
CMD 在执行这个块之前，就会把里面所有的 %变量名% 替换成当时的值。

错误示例（默认情况）：

set NUM=1
if 1==1 (
    set NUM=2
    echo %NUM%
)

**运行结果会输出：1**（而不是 2）。
原因：当 CMD 读到 if 块时，它看到里面有 %NUM%，于是在执行前就把它替换成了 1。即使块里面有 set NUM=2，echo 输出的已经是被替换好的死代码 echo 1。

解决：延迟扩展

加上 enabledelayedexpansion 后，CMD 允许你使用一对感叹号 !变量名! 来引用变量。
当你使用 !变量名! 时，CMD 不会在预处理阶段替换它，而是在代码真正执行到这一行时，才去读取变量的最新值。

正确示例（开启延迟扩展）：

setlocal enabledelayedexpansion
set NUM=1
if 1==1 (
    set NUM=2
    echo !NUM!
)

**运行结果会输出：2**。

---

在前一个脚本中的应用

在您之前发出的 Antigravity CLI 安装脚本中，大量使用了 ! 而不是 %（例如 !MANIFEST_URL!、!TARGET_DIR!）。

这是因为该脚本中：

1. 有大量的 if 判断块。
2. 在循环和判断块内部进行了复杂的字符串截取和替换（例如解析 JSON 时的 set "CLEAN_LINE=!RAW_LINE: =!"）。

如果不开启 setlocal enabledelayedexpansion 并使用感叹号，那些在 if 或 for 循环里临时被赋值的变量，根本无法在同一个代码块中被正确读取，脚本的逻辑就会彻底崩溃。