У меня есть пакетный файл, который запускает несколько сценариев Python, которые вносят изменения в таблицу.

1. Я хочу, чтобы пользователи закомментировали 1-2 сценария Python, которые они не хотят запускать, вместо того, чтобы удалять их из командного файла (чтобы следующий пользователь знал, что эти сценарии существуют как опции!)

2. Я также хочу добавить комментарии, чтобы привлечь их внимание конкретно к переменным, которые им необходимо обновить в пакетном файле, прежде чем они его запустят. Я вижу, что я могу использовать REM. Но похоже, что это больше для обновления пользователя с прогрессом после его запуска.

Есть ли синтаксис для более подходящего добавления комментария?

Команда remдействительно для комментариев. По сути, он не обновляет никого после запуска скрипта. Некоторые авторы сценариев могут использовать его вместо этого echo, потому что по умолчанию пакетный интерпретатор распечатывает каждую команду до ее обработки. Поскольку remкоманды ничего не делают, их можно печатать без побочных эффектов. Чтобы избежать печати команды @, запустите ее с префиксом или, чтобы применить этот параметр во всей программе @echo off. (Это echo offнужно для того , чтобы не печатать дальнейшие команды; @нужно избегать печати этой команды до вступления в силу настройки эха.)

Итак, в вашем командном файле вы можете использовать это:

@echo off
REM To skip the following Python commands, put "REM" before them:
python foo.py
python bar.py

Используйте ::илиREM

::   commenttttttttttt
REM  commenttttttttttt

НО (как отметили люди):

• Если вы используете inline, вам нужно добавить &символ:
  your commands here & :: commenttttttttttt
• Внутри вложенной логики ( IF/ELSE, FORпетли и т.д. ...) использованиеREM , потому что ::дает ошибку.
• :: может потерпеть неудачу в течение setlocal ENABLEDELAYEDEXPANSION

Нет, простые старые командные файлы используют REMв качестве комментария. ECHOэто команда, которая печатает что-то на экране.

Чтобы «закомментировать» разделы файла, вы можете использовать GOTO. Пример всех этих команд / методов:

REM it starts here the section below can be safely erased once the file is customised
ECHO Hey you need to edit this file before running it!  Check the instructions inside
ECHO Now press ctrl-c to interrupt execution or enter to continue
PAUSE
REM erase the section above once you have customised the file
python executed1.py
ECHO Skipping some stuff now
GOTO End
python skipped1.py
python skipped2.py
:END
python executed2.py

Что я могу сказать? пакетные файлы - это пережиток давних времен, они неуклюжие и уродливые.

Вы можете прочитать больше на этом сайте .

РЕДАКТИРОВАТЬ: немного изменил пример, чтобы он содержал элементы, которые вы, очевидно, ищете.

:: вместо REM предпочтительно использовался в те дни, когда компьютеры работали не очень быстро. REM-строки читаются, а затем обрабатываются. Строка :: игнорируется полностью. Это может ускорить ваш код в «старые времена». Еще больше после REM вам нужен пробел, после :: вы не делаете.

И, как сказано в первом комментарии: вы можете добавить информацию в любую строку, в которой вы чувствуете необходимость

SET DATETIME=%DTS:~0,8%-%DTS:~8,6% ::Makes YYYYMMDD-HHMMSS

Что касается пропуска деталей. Помещение REM перед каждой строкой может занять довольно много времени. Как уже упоминалось, использование GOTO для пропуска частей - это простой способ пропустить большие куски кода. Обязательно установите: LABEL в той точке, в которой вы хотите, чтобы код продолжался.

SOME CODE

GOTO LABEL  ::REM OUT THIS LINE TO EXECUTE THE CODE BETWEEN THIS GOTO AND :LABEL

SOME CODE TO SKIP
.
LAST LINE OF CODE TO SKIP

:LABEL
CODE TO EXECUTE

Многострочные комментарии

Если есть большое количество строк, которые вы хотите закомментировать, то было бы лучше, если бы вы могли делать многострочные комментарии, а не комментировать каждую строку.

Смотрите этот пост Роба ван дер Вуде в комментариях :

В пакетном языке нет блоков комментариев, хотя есть способы добиться эффекта.

GOTO EndComment1
This line is comment.
And so is this line.
And this one...
:EndComment1

Вы можете использовать GOTOLabel и: Label для создания блочных комментариев.

Или, если блок комментариев появляется в конце пакетного файла, вы можете написать EXITв конце кода, а затем любое количество комментариев для вашего понимания.

@ECHO OFF
REM Do something
  •
  •
REM End of code; use GOTO:EOF instead of EXIT for Windows NT and later
EXIT

Start of comment block at end of batch file
This line is comment.
And so is this line.
And this one...

Размещение комментариев в одной строке с командами: используйте & :: comment

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

Объяснение:

&разделяет две команды , поэтому в данном случае color Cэто первая команда и :: set red font colorвторая.

Важный:

Это утверждение с комментарием выглядит интуитивно правильным:

goto error1         :: handling the error

но это не допустимое использование комментария. Это работает только потому, что gotoигнорирует все аргументы после первого. Доказательство легко, это gotoтакже не подведет:

goto error1 handling the error

Но похожая попытка

color 17            :: grey on blue

не удается выполнить команду из - за 4 аргументов неизвестной к colorкоманде: ::, grey, on,blue .

Это будет работать только как:

color 17     &      :: grey on blue

Так что амперсанд неизбежен.

Вы можете что-то закомментировать, используя ::или REM:

your commands here
:: commenttttttttttt

или

your commands here
REM  commenttttttttttt

Чтобы сделать это в той же строке, что и команда, необходимо добавить амперсанд:

your commands here      & ::  commenttttttttttt

или

your commands here      & REM  commenttttttttttt

Замечания:

• Использование :: во вложенной логике ( IF-ELSE, FORциклов и т. Д.) Вызовет ошибку. В этих случаях используйте REMвместо этого.

Это старая тема, и я хотел бы добавить свое понимание здесь, чтобы расширить знания этой интересной темы.

Основное различие между REM и :::

REM сама команда, а :: НЕ.

Мы можем рассматривать :: как токен, который, как только синтаксический анализатор CMD обнаружит первый непустой пробел в строке, будет следующим :: токеном, он просто пропустит всю строку и прочитает следующую строку. Вот почему за REM должен следовать хотя бы пробел, чтобы он мог функционировать в качестве комментария для строки, в то время как :: не нужно никакого пробела позади него.

Это РЗМ команда сама по себе может быть лучше понято из нижеследующего FOR синтаксиса

Основной синтаксис FOR следующий

FOR %v in (set) DO <Command> [command param] 

здесь <Command>может быть любая действительная команда. Таким образом, мы можем написать следующую действительную командную строку как remкоманду

FOR %i in (1,2,3) DO rem echo %i

Тем не менее, мы не можем написать следующую строку, так как ::это не команда

FOR %i in (1,2,3) DO :: echo %i

Вы можете добавить комментарии в конец командного файла с этим синтаксисом:

@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

Просто убедитесь, что вы никогда не используете закрывающие скобки.

Атрибуты: Лео Гуттирез Рамирес на https://www.robvanderwoude.com/comments.php