如何在批处理脚本中添加注释

1. 使用 rem 命令（推荐）

rem 是专门用于添加注释的命令，语法为：

rem 这是一行注释，可以说明脚本的功能或某段代码的作用

示例：

@echo off
rem 此脚本用于将当前目录下的所有.txt文件重命名为.bat文件
for %%i in (*.txt) do (
    ren "%%i" "%%~ni.bat"  rem 重命名单个文件
)
rem 输出完成信息并暂停
echo 重命名完成
pause

2. 使用 :: 标签（简洁写法）

:: 是一个标签命令，批处理不会执行它，因此可以用作注释：

:: 这是另一种注释方式，比rem更简洁

注意：:: 不能用于括号内（如 for 循环或 if 语句），否则会导致语法错误。例如：

for %%i in (*.txt) do (
    :: 这行会导致错误！
    ren "%%i" "%%~ni.bat"
)

3. 行末注释

可以在命令后面直接添加注释，但需要用 rem 或 ::：

echo Hello World  rem 输出问候语

4. 块注释技巧

如果需要注释多行代码，可以使用 goto 配合标签：

:comment
echo 这行不会被执行
echo 这行也不会被执行
goto :eof  rem 跳到脚本末尾，跳过注释块

echo 这行才会被执行

注释规范建议

• 单行注释：使用 rem 或 ::，保持简洁。
• 多行注释：使用多个 rem 或块注释技巧。
• 代码解释：在关键命令后添加简短注释，说明功能。
• 文件头部：在脚本开头用 rem 说明脚本用途、作者和日期。

示例：

@echo off
rem =====================================
rem 脚本名称：txt_to_bat_rename.bat
rem 功能：将当前目录下所有.txt文件重命名为.bat文件
rem 作者：Your Name
rem 日期：2025-05-10
rem =====================================

for %%i in (*.txt) do (
    ren "%%i" "%%~ni.bat"  rem 执行重命名操作
)
echo 重命名完成！
pause