用途
该技能用于创建、编辑、调试和维护 Windows 批处理文件（.bat/.cmd）。适用场景包括：创建或编辑 .bat 或 .cmd 文件；自动化 Windows 任务（文件操作、部署、备份）；构建用于 PATH 上 bin/ 文件夹的 CLI 工具；编写计划任务脚本（SCHTASKS、任务计划程序）；调试批处理脚本问题（变量展开、错误级别、引号）；将批处理脚本与外部工具集成（curl、git、Node.js、Python）；使用结构化模板搭建新的批处理项目。
前置条件
- 基于 Windows NT 的操作系统（Windows 7 或更高版本）
- cmd.exe（内置）
- 可选：PATH 上的 bin/ 目录，用于将脚本作为命令分发
- 可选：PATHEXT 配置为包含 .BAT;.CMD（Windows 默认）
命令解释
cmd.exe 按顺序通过四个阶段处理每一行：变量替换、引号与转义、语法解析、重定向。变量替换会将 %VAR% 替换为环境变量值，%0–%9 引用批处理参数，%* 展开为所有参数。引号与转义部分说明插入符 ^ 用于转义特殊字符，引号可防止内部特殊字符被解释，批处理文件中 %% 产生字面量 %。语法解析会将行拆分为管道、复合命令和括号分组。重定向包括 > 覆盖、>> 追加、< 读取输入、2> 重定向 stderr、2>&1 合并、>NUL 丢弃输出。
变量
环境变量使用 set 定义，等号周围不能有空格。特殊变量包括 %CD%、%DATE%、%TIME%、%RANDOM%、%ERRORLEVEL%、%USERNAME%、%USERPROFILE%、%TEMP%/%TMP%、%PATHEXT%、%COMSPEC%。作用域使用 setlocal/endlocal，可通过 endlocal & set _RESULT=%_LOCAL_VAR% 返回值。延迟展开用于括号块内运行时求值，!VAR! 在运行时展开，%VAR% 在解析时展开。
控制流
条件执行支持 if exist、if not defined、字符串比较和 ERRORLEVEL 判断。比较运算符有 equ、neq、lss、leq、gtr、geq，/i 用于不区分大小写比较。复合命令包括 &、&&、||。FOR 循环支持值集合、数字范围、目录文件、递归搜索、仅目录、解析命令输出、解析文件行。GOTO 与标签用于跳转，goto :eof 退出当前批处理或子程序。
命令行参数
包括 %0 脚本名、%1–%9 位置参数、%* 所有参数、%~1 去引号参数、%~f1 完整路径、%~d1 盘符、%~p1 路径、%~n1 文件名、%~x1 扩展名、%~dp0 脚本所在盘符与路径、%~nx0 脚本文件名与扩展名、%~z1 文件大小、%~$PATH:1 在 PATH 中搜索。参数解析模式通过 :parse_args 标签循环处理。
字符串处理
支持子串提取（%~STR:~0,5% 等）、搜索替换（%~STR:World=Earth%）、子串包含测试。
函数
函数使用标签、CALL 和 SETLOCAL/ENDLOCAL。call :label args 调用函数，exit /b 从函数返回，使用 endlocal & set 技巧将值传出作用域块。
算术
set /a 执行 32 位有符号整数运算，支持 + - * / %% ( ) 以及位运算 & | ^ ~ << >>，支持十六进制和八进制字面量。
错误处理
错误级别约定：0 表示成功，非零表示失败。提供快速失败模式和设置退出码的方法。
常用命令参考
按类别列出：文件操作（DIR、COPY、XCOPY、ROBOCOPY、MOVE、DEL、REN、MD/MKDIR、RD/RMDIR、MKLINK、ATTRIB、TYPE、MORE、TREE、REPLACE、COMPACT、EXPAND、MAKECAB、TAR）；文本搜索与处理（FIND、FINDSTR、SORT、CLIP、FC、COMP、CERTUTIL）；系统信息（SYSTEMINFO、HOSTNAME、VER、WHOAMI、TASKLIST、TASKKILL、WMIC、SC、DRIVERQUERY、REG、SETX）；网络（PING、IPCONFIG、NSLOOKUP、NETSTAT、TRACERT、NET USE、NET USER、NETSH、ARP、ROUTE、CURL、SSH）；计划任务与自动化（SCHTASKS、TIMEOUT、START、RUNAS、SHUTDOWN、FORFILES）；Shell 实用工具（WHERE、DOSKEY、CHOICE、MODE、SUBST、CHCP、COLOR、TITLE、ASSOC/FTYPE）。
Shell 语法与表达式
括号用于分组以统一重定向或条件执行。转义字符 ^ 可转义下一个字符。通配符 * 和 ? 可用。重定向总结包括 >、>>、2>、2>&1、<、>NUL 2>&1。
编写生产级批处理文件
提供标准脚本结构，包含 @echo off、setlocal EnableDelayedExpansion、:main、:parse_args、:usage 等标签。最佳实践包括：始终以 @echo off 和 setlocal 开头；处理前验证输入；引用路径与变量；使用 exit /b 而非 exit；返回有意义的退出码；使用 %~dp0 获取脚本相对路径；优先 ROBOCOPY 而非 XCOPY；在循环或括号块中修改变量时启用延迟展开；将错误写入 stderr；使用 REM 注释。
安全注意事项
不要在批处理文件中存储凭证；验证用户输入；使用 SETLOCAL 防止变量泄漏；净化文件路径；避免使用 SET /P 处理敏感输入。
调试与故障排除
提供多种技巧：跟踪执行、逐步运行、检查错误级别、检查变量、延迟展开问题、FOR 循环 %% 与 %、SET 中的空格、管道中的插入符、SET /A 中的括号、模运算需双百分号。
跨平台与扩展工具
当批处理脚本达到极限时，可使用 Cygwin、MSYS2、WSL、GnuWin32、PowerShell 扩展 cmd.exe 能力。当需要快速启动、简单文件操作、基于 PATH 的 CLI 工具或任务计划程序集成时使用批处理；复杂数据处理、REST API 或面向对象脚本考虑使用 PowerShell 或 WSL。
CMD 键盘快捷键
包括 Tab 自动补全、上下箭头浏览历史、F7 历史弹出、F3 重复上一条命令、Esc 清除当前行、Ctrl+C 取消运行、Alt+F7 清除历史。
参考文件
references/ 文件夹包含：tools-and-resources.md、batch-files-and-functions.md、windows-commands.md、cygwin.md、msys2.md、windows-subsystem-on-linux.md。
资产模板
assets/ 文件夹包含文本格式的起始批处理文件模板数据：executable.txt（带参数解析的独立 CLI 工具）、library.txt（可复用的函数库）、task.txt（计划任务/自动化脚本）。