批处理脚本中SCP命令使用变量失效的问题及解决

问题场景 #

直接执行scp filename destination可正常完成文件传输，但将文件名存入变量并在if语句块中使用时，变量无法被正确识别，导致SCP命令报错。

问题代码片段（位于if语句内）：

set /p "var=filename"
echo %var%
echo scp "%var%" destination
scp "%var%" destination

执行输出：

filename
scp "" destination
: not a regular file

可见第二个echo与SCP命令中%var%输出为空，导致命令执行失败。

解决方案 #

启用延迟环境变量扩展，将变量引用方式从%var%改为!var!。

修改后的示例代码：

@echo off
setlocal enabledelayedexpansion

:: 示例if语句块
if exist "somefile.txt" (
    set /p "var=filename"
    echo !var!
    echo scp "!var!" destination
    scp "!var!" destination
)

endlocal

原因说明 #

批处理执行代码块（如if/for包裹的代码段）时，会预先解析整个代码块内的%变量%，用解析时的变量值替换。如果变量是在代码块内定义/修改的，解析阶段变量还未赋值，就会被替换为空字符串。启用延迟扩展后，!变量!会在代码执行到该行时才解析变量值，避免提前替换的问题。

内容的提问来源于stack exchange，提问作者Leon