我更喜欢用:

REM评论 &REM内联注释

例子:

@echo off
set parameter1=%1%
REM test if the parameter 1 was received
if defined parameter1 echo The parameter 1 is %parameter1% &REM Display the parameter

注释一行

对于注释行，使用REM或::though::可能会在括号内失败

在以!<分隔符开头的延迟展开行中，>将被忽略，因此可以用于注释:

@echo off

setlocal enableDelayedExpansion

echo delayed expansion activated
!;delayed expansion commented line
echo end of the demonstration

在行末注释

对于行末的注释，您可以再次使用rem和::结合&:

echo --- &:: comment (should not be the last line in the script)
echo --- &rem comment

在文件末尾注释

因为exit命令后会被解析，你可以使用它在文件末尾添加注释:

@echo off

echo commands

exit /b 

-------------------
commnts at the end 
of the file
------------------

内联注释

不存在的变量的展开将被什么都不替换，并且设置一个变量=相当困难，你可以在内联注释中使用这个:

@echo off

echo long command %= this is a comment =% with an inline comment

多行注释

对于多行注释，可以使用GOTO(用于括号外)和REM带有条件执行(用于括号内)。详情如下:

@echo off

echo starting script

goto :end_comments
 comented line 
 one more commented line
:end_comments

echo continue with the script

(
    echo demonstration off
    rem/||(
      lines with
      comments
    )
    echo multiline comment inside
    echo brackets
)

同样的技术用宏来美化:

@echo off

::GOTO comment macro
set "[:=goto :]%%"
::brackets comment macros
set "[=rem/||(" & set "]=)"

::testing
echo not commented 1

%[:%
  multi 
  line
  comment outside of brackets
%:]%

echo not commented 2

%[:%
  second multi 
  line
  comment outside of brackets
%:]%

::GOTO macro cannot be used inside for
for %%a in (first second) do (
    echo first not commented line of the %%a execution
    %[%
        multi line
        comment
    %]%
    echo second not commented line of the %%a execution
)

将注释与命令:use &:: comment放在同一行

color C          & :: set red font color
echo IMPORTANT INFORMATION
color            & :: reset the color to default

解释:

&分隔了两个命令，因此在本例中，color C是第一个命令，::set红色字体颜色是第二个命令。

重要的是:

这个带有注释的语句直观上看起来是正确的:

goto error1         :: handling the error

但这不是注释的有效使用。它之所以有效，只是因为goto忽略了第一个参数之后的所有参数。证明很简单，这个goto也不会失败:

goto error1 handling the error

但是类似的尝试

color 17            :: grey on blue

原因:::，grey, on, blue 4个参数与color命令不匹配，导致命令执行失败。

它只会工作:

color 17     &      :: grey on blue

所以&是不可避免的。

你可以使用::或REM来注释一些东西:

your commands here
:: commenttttttttttt

or

your commands here
REM  commenttttttttttt

为了在同一行执行命令，你必须添加一个&号:

your commands here      & ::  commenttttttttttt

or

your commands here      & REM  commenttttttttttt

注意:

在嵌套逻辑(IF-ELSE, FOR循环等)中使用::将导致错误。在这种情况下，用REM代替。

使用::或REM

::   commenttttttttttt
REM  commenttttttttttt

但是(正如人们所指出的):

如果它们不在行首，则添加&字符: 你的命令在这里&::commenttttttttttt 在嵌套部分(IF/ELSE, FOR循环等…)::后面应该跟着法线，否则会给出错误(在那里使用REM)。 ::在setlocal enabledelayeexpansion中也可能失败

你可以用下面的语法在批处理文件的末尾添加注释:

@echo off
:: Start of code
...
:: End of code

(I am a comment
So I am!
This can be only at the end of batch files

只是要确保不要使用右括号。

署名:Leo Guttirez Ramirez, https://www.robvanderwoude.com/comments.php