延迟变量展开是什么
CMD 解析命令时，同一个括号代码块（或 for 循环体）会先被整体读入并一次性替换掉所有 %变量%，然后再逐条执行。结果是：块内被修改的变量，用 %var% 读到的仍是进入块之前的旧值。延迟变量展开把「取值」推迟到每条命令真正执行的那一刻，语法是 !var!，开启方式是 setlocal enabledelayedexpansion。这是批处理最容易踩的语法坑之一，也是写出正确循环统计、逐行处理文件的前提。
基本信息
| 适用平台 | Windows 全版本 CMD、.bat/.cmd 批处理 |
|---|---|
| 开启方式 | setlocal enabledelayedexpansion（脚本内）或 cmd /v:on（交互式会话） |
| 取值语法 | %var% 解析时展开、!var! 执行时展开 |
| 作用范围 | setlocal 到 endlocal 或脚本结束；setlocal 可嵌套 |
| 配套写法 | 可先 setlocal enableextensions enabledelayedexpansion 一次开启两项 |
典型使用场景
- 循环累加与计数：for 循环里累计行数、文件数、大小，必须用 !sum!
- 逐行处理：for /f 读取文件每次拿到一行，脚本里判断、拼接要用 !line!
- 动态拼接变量名：用 !name%i%! 之类组合构造变量，处理成组配置项
- 字符串替换与切片：块内做 %var:旧=新% 后立刻读结果，需延迟展开配合
- 错误累计：循环里记录失败次数，结束后统一判断是否需要告警
常用示例
常用示例
@echo off
setlocal enabledelayedexpansion
set /a sum=0
for /l %%i in (1,1,5) do (
set /a sum+=%%i # 块内修改 sum
echo 当前累计: !sum! # 用 ! 读到修改后的新值
)
echo 最终合计: %sum% # 块外可以用 %
REM 逐行读取并统计含 ERROR 的行数
set /a err=0
for /f "delims=" %%L in (app.log) do (
echo %%L | find /i "ERROR" >nul && set /a err+=1
)
echo 错误行数: !err!两种写法对照
| 写法 | 展开时机 | 适用场合 |
|---|---|---|
| %var% | 进入块前一次性替换 | 块外使用；进入循环前的初始值 |
| !var! | 每条命令执行时替换 | 块内、循环内读取最新值 |
| call echo %%var%% | 借用 call 再解析一遍 | 老式替代写法，可读性差 |
| setlocal / endlocal | 划定变量作用域 | 脚本收尾要恢复原环境 |
| cmd /v:on | 整个会话开启延迟展开 | 交互式调试与命令行验证 |
忘记 setlocal enabledelayedexpansion 时，!var! 不会被解析，而是原样打印出来，看起来像「变量没赋值」，实际是语法没开。反过来，开启之后 ! 变成元字符，数据里的感叹号会被解析掉。
延迟展开是会话级开关：同一脚本里 setlocal 之前的代码不受影响；需要临时处理含 ! 的数据时，可以在 setlocal disabledelayedexpansion 段内完成，再切回来。
含感叹号的数据怎么处理
含感叹号的数据怎么处理
@echo off
setlocal enabledelayedexpansion
set "pwd=P@ss!word" # 危险：赋值时 !word 会被当作变量
setlocal disabledelayedexpansion
set "pwd=P@ss!word" # 安全：此段内 ! 按普通字符处理
setlocal enabledelayedexpansion
set "pwd2=abc^!def" # 转义写法，^! 表示字面感叹号
REM 文件名含 ! 时同样要在关闭延迟展开的状态下处理处理含感叹号的数据（密码、文件名、JSON 文本）时开启延迟展开会被静默破坏内容：P@ss!word 会变成 P@ss，且不报错。此类场景建议整体改用 PowerShell。