Arquivos Batch

Uma habilidade abrangente para criar, editar, depurar e manter arquivos batch do Windows (.bat/.cmd) usando cmd.exe. Aplica-se ao desenvolvimento de ferramentas CLI, automação de administração de sistemas, tarefas agendadas, scripts de operações de arquivos e scripts executáveis baseados em PATH.

Quando Usar Esta Habilidade

• Criar ou editar arquivos .bat ou .cmd
• Automatizar tarefas do Windows (operações de arquivos, implantações, backups)
• Construir ferramentas CLI destinadas a uma pasta bin/ no PATH
• Escrever scripts de tarefas agendadas (SCHTASKS, Agendador de Tarefas)
• Depurar problemas de script batch (expansão de variáveis, níveis de erro, aspas)
• Integrar scripts batch com ferramentas externas (curl, git, Node.js, Python)
• Estruturar novos projetos baseados em batch com modelos estruturados

Pré-requisitos

• SO baseado em Windows NT (Windows 7 ou posterior)
• cmd.exe (integrado)
• Opcional: um diretório bin/ no PATH para distribuir scripts como comandos
• Opcional: PATHEXT configurado para incluir .BAT;.CMD (padrão no Windows)

Interpretação de Comandos

O cmd.exe processa cada linha em quatro estágios, em ordem:

1. Substituição de variáveis — Tokens %VAR% são substituídos por valores de variáveis de ambiente. %0–%9 referenciam argumentos do script. %* expande para todos os argumentos.
2. Aspas e escape — O acento circunflexo ^ faz o escape de caracteres especiais (& | < > ^). As aspas impedem a interpretação de caracteres especiais contidos nelas. Em arquivos batch, %% resulta em um % literal.
3. Análise de sintaxe — As linhas são divididas em pipelines (|), comandos compostos (&, &&, ||) e grupos entre parênteses ( ).
4. Redirecionamento — > sobrescreve, >> anexa, < lê entrada, 2> redireciona stderr, 2>&1 mescla stderr com stdout, >NUL descarta a saída.

Variáveis

Variáveis de Ambiente

set _MY_VAR=Hello World
echo %_MY_VAR%
set _MY_VAR=

• set sem argumentos lista todas as variáveis
• set _PREFIX lista variáveis que começam com _PREFIX
• Sem espaços em torno de = — set name = val define a variável "name " para " val"

Variáveis Especiais

Escopo com SETLOCAL / ENDLOCAL

setlocal
set _LOCAL_VAR=scoped value
endlocal
REM _LOCAL_VAR is no longer defined here

Para retornar um valor de um bloco com escopo:

endlocal & set _RESULT=%_LOCAL_VAR%

Expansão Atrasada

Variáveis dentro de blocos entre parênteses são expandidas no momento da análise. Use expansão atrasada para avaliação em tempo de execução:

setlocal EnableDelayedExpansion
set _COUNT=0
for /l %%i in (1,1,5) do (
    set /a _COUNT+=1
    echo !_COUNT!
)
endlocal

• !VAR! expande no tempo de execução (atrasado)
• %VAR% expande no tempo de análise (imediato)

Fluxo de Controle

Execução Condicional

if exist "output.txt" echo File found
if not defined _MY_VAR echo Variable not set
if "%_STATUS%"=="ready" (echo Go) else (echo Wait)
if %ERRORLEVEL% neq 0 echo Command failed

Operadores de comparação: equ, neq, lss, leq, gtr, geq. Use /i para comparação de strings sem distinção entre maiúsculas e minúsculas.

Comandos Compostos

command1 & command2        & REM Always run both
command1 && command2       & REM Run command2 only if command1 succeeds
command1 || command2       & REM Run command2 only if command1 fails

Loops FOR

REM Iterate over a set of values
for %%i in (alpha beta gamma) do echo %%i

REM Numeric range: start, step, end
for /l %%i in (1,1,10) do echo %%i

REM Files in a directory
for %%f in (*.txt) do echo %%f

REM Recursive file search
for /r %%f in (*.log) do echo %%f

REM Directories only
for /d %%d in (*) do echo %%d

REM Parse command output
for /f "tokens=1,2 delims=:" %%a in ('ipconfig ^| findstr "IPv4"') do echo %%b

REM Parse file lines
for /f "usebackq tokens=*" %%a in ("data.txt") do echo %%a

GOTO e Rótulos

goto :main_logic
:usage
echo Usage: %~nx0 [options]
exit /b 1

:main_logic
echo Running main logic...
goto :eof

goto :eof sai do script ou sub-rotina atual. Rótulos começam com :.

Argumentos de Linha de Comando

…