Windows Batch (.bat) 脚本语法详解：从入门到实战

一、 引言：什么是 Batch 脚本？

Batch 文件（.bat或.cmd）是一种文本文件，包含一系列 Windows 命令，按顺序执行。它类似于 Linux/Unix 系统中的 Shell 脚本（.sh），主要用于自动化重复性任务、批处理操作、系统管理、环境配置等。

虽然 PowerShell 功能更强大、更现代，但对于一些简单的自动化任务或在某些受限环境中，.bat脚本仍然是一个快速有效的解决方案。

二、 创建和运行 Bat 文件

1. 创建: 使用任何纯文本编辑器（如 Notepad, VS Code, Sublime Text）创建一个文件，例如my_script.bat。
2. 编写: 在文件中写入命令。
3. 保存: 确保文件扩展名为.bat。
4. 运行:
   • 双击.bat文件图标（在 Windows 资源管理器中）。
   • 在命令提示符（CMD）中，导航到脚本所在目录，然后输入脚本名称（例如my_script.bat）并按回车。
   • 在 CMD 中直接输入完整路径（例如C:\path\to\my_script.bat）。

三、 基础语法与命令

1. 注释

在.bat脚本中，使用REM(Remark) 或::来添加注释。::后面的内容会被完全忽略，而REM后面的内容也会被忽略，但REM本身仍被视为命令的一部分（尽管不执行任何操作）。

REM 这是一个注释 ECHO Hello World! :: 这也是一个注释 ECHO Goodbye!

2. 命令回显

默认情况下，命令提示符会显示脚本中执行的每一行命令。使用@ECHO OFF可以关闭这种回显，使输出更干净。通常，@ECHO OFF会放在脚本的第一行。@符号用于抑制该命令本身的回显。

@ECHO OFF ECHO This line will print without showing the command itself. ECHO Hello from script! PAUSE

3. 变量

• 环境变量: Windows 提供了许多预定义的环境变量，如%PATH%,%USERNAME%,%USERPROFILE%,%OS%,%DATE%,%TIME%等。你也可以设置自己的环境变量。
• 用户定义变量: 使用SET命令来设置变量。

  SET MYVAR=Hello World ECHO %MYVAR%

• 命令行参数: 当你运行脚本时传入的参数，可以用%0到%9来引用。%0是脚本本身的路径，%1是第一个参数，%2是第二个参数，以此类推。%*表示所有参数。

  @ECHO OFF ECHO Script Name: %0 ECHO First Argument: %1 ECHO Second Argument: %2 ECHO All Arguments: %*

4. 控制流：条件判断 (IF)

IF语句用于根据条件执行不同的命令块。

• 比较字符串:

  SET INPUT=apple IF "%INPUT%"=="apple" ( ECHO You entered apple! ) ELSE ( ECHO You did not enter apple. )

  注意: 字符串比较时，最好用双引号将变量和字符串括起来，以处理包含空格的情况。

• 比较数字:

  SET NUM=10 IF %NUM% EQU 10 ( ECHO Number is equal to 10. ) ELSE ( ECHO Number is not equal to 10. )

  • EQU: Equal To
  • NEQ: Not Equal To
  • LSS: Less Than
  • LEQ: Less Than or Equal To
  • GTR: Greater Than
  • GEQ: Greater Than or Equal To

• 检查文件或目录是否存在:

  IF EXIST "C:\temp" ( ECHO Directory exists. ) ELSE ( ECHO Directory does not exist. ) IF NOT EXIST "C:\somefile.txt" ( ECHO File does not exist. )

• 检查错误级别 (ERRORLEVEL): 许多命令执行后会设置一个错误级别码（0 通常表示成功，非 0 表示失败）。IF ERRORLEVEL n会检查错误级别是否大于或等于n。

  REM 假设某个命令可能失败 dir nonexistent_directory IF ERRORLEVEL 1 ( ECHO The previous command failed. ) ELSE ( ECHO The previous command succeeded. )

  • 推荐替代: 现代写法更倾向于使用||(或) 和&&(与) 操作符来处理命令的成功或失败。

    dir nonexistent_directory || ECHO Command failed dir existing_directory && ECHO Command succeeded

5. 循环 (FOR)

FOR循环用于重复执行命令。

• 遍历列表:

  FOR %%i IN (apple banana cherry) DO ( ECHO Fruit: %%i )

  注意: 在脚本中使用FOR循环时，循环变量（如i）前面需要两个百分号%%。在命令行直接执行时，只需要一个%。

• 遍历文件:

  FOR %%f IN (*.txt) DO ( ECHO Processing file: %%f REM Add commands to process each .txt file here )

• 遍历目录:

  FOR /D %%d IN (*) DO ( ECHO Directory: %%d )

• 数字范围循环 (FOR /L):

  FOR /L %%i IN (1, 1, 5) DO ( ECHO Count: %%i )

  这表示从 1 开始 (1)，每次增加 1 (1)，直到 5 (5)。

• 遍历命令输出 (FOR /F): 这个选项非常强大，可以处理另一个命令的输出。

  FOR /F "tokens=*" %%a IN ('dir /b *.txt') DO ( ECHO Found text file: %%a )

  'dir /b *.txt'是要执行的命令。tokens=*表示将整行输出作为一个令牌赋值给变量%%a。

6. 跳转 (GOTO)

GOTO语句用于无条件跳转到脚本中标记的位置（标签）。标签以冒号:开头。

@ECHO OFF ECHO Starting... GOTO :middle ECHO This line will never execute :middle ECHO In the middle! :end ECHO Ending...

7. 退出 (EXIT)

• EXIT: 终止脚本执行。
• EXIT /B: 从子程序或脚本中退出，而不终止整个 CMD 会话（如果是在 CMD 中直接调用脚本）。
• EXIT /B errorlevel: 可以指定一个错误级别码退出。

8. 其他常用命令

• ECHO [message]: 显示消息或控制回显。
• PAUSE: 暂停脚本执行，等待用户按键。
• CLS: 清屏。
• CD /D [path]: 改变当前驱动器和目录。
• MD/MKDIR [dirname]: 创建目录。
• RD/RMDIR [dirname]: 删除目录。
• COPY [source] [destination]: 复制文件。
• MOVE [source] [destination]: 移动文件。
• DEL/ERASE [filename]: 删除文件。
• TYPE [filename]: 显示文件内容。
• START [program]: 启动一个程序或打开一个文件/URL。
• CALL [script.bat]: 调用另一个批处理脚本，执行完后返回当前脚本继续执行。如果不用CALL，则会执行另一个脚本后不再返回。

四、 实战示例

示例 1: 简单备份脚本

@ECHO OFF SETLOCAL ENABLEDELAYEDEXPANSION REM --- Backup Script Configuration --- SET SOURCE_DIR=C:\MyData SET BACKUP_DIR=D:\Backup SET TIMESTAMP=%DATE:~0,4%_%DATE:~5,2%_%DATE:~8,2%_%TIME:~0,2%_%TIME:~3,2%_%TIME:~6,2% SET TIMESTAMP=!TIMESTAMP: =0! REM Replace spaces in time with 0 SET BACKUP_NAME=Backup_!TIMESTAMP! REM Check if source directory exists IF NOT EXIST "!SOURCE_DIR!" ( ECHO Error: Source directory !SOURCE_DIR! does not exist. PAUSE EXIT /B 1 ) REM Create backup directory MD "!BACKUP_DIR!\!BACKUP_NAME!" REM Perform copy XCOPY "!SOURCE_DIR!" "!BACKUP_DIR!\!BACKUP_NAME!" /E /I /Y ECHO Backup completed: !BACKUP_NAME! PAUSE

• SETLOCAL ENABLEDELAYEDEXPANSION: 启用延迟变量扩展，这对于在循环中修改和使用变量很有用（虽然这里没用到，但这是一个好习惯）。
• !VARIABLE!: 使用!而不是%来引用在ENABLEDELAYEDEXPANSION后被修改的变量。
• %DATE:~offset,length%: 字符串切片操作，用于从日期字符串中提取年月日。
• XCOPY: 更强大的复制命令，/E包含空子目录，/I如果目标不存在则假设它是目录，/Y不提示确认覆盖。

示例 2: 交互式菜单脚本

@ECHO OFF :menu CLS ECHO. ECHO Main Menu ECHO ========= ECHO 1. Say Hello ECHO 2. List Files in Current Directory ECHO 3. Exit ECHO. SET /P CHOICE=Enter your choice (1-3): IF "%CHOICE%"=="1" GOTO :say_hello IF "%CHOICE%"=="2" GOTO :list_files IF "%CHOICE%"=="3" GOTO :exit_script ECHO Invalid choice. Please try again. PAUSE GOTO :menu :say_hello ECHO. ECHO Hello, World! PAUSE GOTO :menu :list_files ECHO. DIR PAUSE GOTO :menu :exit_script ECHO. ECHO Thank you for using this script. Goodbye! PAUSE

• SET /P: 提示用户输入并存储到变量。
• 使用GOTO和标签 (:label) 创建菜单循环。

五、 注意事项与最佳实践

1. 路径和空格: 包含空格的路径需要用双引号括起来，如"C:\Program Files\MyApp".
2. 变量引用: 始终使用双引号将变量括起来进行比较或使用，如"%VAR%"，以避免因为空格或特殊字符导致的问题。
3. 错误处理: 考虑命令执行失败的可能性，并进行适当的处理（使用||,&&,IF ERRORLEVEL,EXIT /B）。
4. SETLOCAL和ENDLOCAL: 在脚本开头使用SETLOCAL可以创建一个局部环境，脚本结束时会自动恢复之前的环境变量设置，防止污染全局环境。
5. 调试: 在开发阶段，可以暂时去掉@ECHO OFF，查看脚本实际执行的命令。

六、 总结

Windows Batch 脚本虽然语法相对简单，但功能强大，对于自动化日常任务非常有用。掌握其基础语法（变量、条件、循环、跳转）和常用命令，可以大大提高工作效率。尽管 PowerShell 是更现代的选择，但.bat脚本因其简单性和普遍性，在许多场景下依然不可或缺。