Eu tenho um arquivo em lotes que executa vários scripts python que fazem modificações na tabela.

1. Quero que os usuários comentem os scripts python 1-2 que eles não desejam executar, em vez de removê-los do arquivo em lotes (para que o próximo usuário saiba que esses scripts existem como opções!)

2. Também quero adicionar comentários para chamar a atenção deles especificamente para as variáveis ​​que eles precisam atualizar no arquivo em lotes antes de executá-lo. Vejo que posso usar REM. Mas parece que isso é mais para atualizar o usuário com progresso depois de executá-lo.

Existe uma sintaxe para adicionar um comentário de maneira mais apropriada?

O remcomando é de fato para comentários. Ele não atualiza inerentemente ninguém depois de executar o script. Alguns autores de scripts podem usá-lo dessa maneira em vez de echo, porque, por padrão, o interpretador de lote imprime cada comando antes de ser processado. Como os remcomandos não fazem nada, é seguro imprimi-los sem efeitos colaterais. Para evitar a impressão de um comando, prefixe-o com @, ou, para aplicar essa configuração ao longo do programa, execute @echo off. (É echo offpara evitar a impressão de mais comandos; @é para evitar a impressão desse comando antes que a configuração de eco entre em vigor.)

Portanto, no seu arquivo em lotes, você pode usar o seguinte:

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

Use ::ouREM

::   commenttttttttttt
REM  commenttttttttttt

MAS (como as pessoas observaram):

• Se você usar inline, precisará adicionar &caracteres:
  your commands here & :: commenttttttttttt
• A lógica aninhada interna ( IF/ELSE, FORloops, etc ...) é usada REMporque ::gera um erro.
• :: pode falhar dentro setlocal ENABLEDELAYEDEXPANSION

Não, arquivos em lote antigos simples são usados REMcomo comentário. ECHOé o comando que imprime algo na tela.

Para "comentar" seções do arquivo que você pode usar GOTO. Um exemplo de todos esses comandos / técnicas:

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

O que posso dizer? os arquivos em lote são uma relíquia dos tempos antigos, são desajeitados e feios.

Você pode ler mais neste site .

EDIT: modificou um pouco o exemplo para que ele contenha os elementos que você aparentemente está procurando.

O :: em vez do REM foi usado preferencialmente nos dias em que os computadores não eram muito rápidos. As linhas REM são lidas e depois ignoradas. As linhas :: 'ed são ignoradas por todo o caminho. Isso pode acelerar o seu código nos "velhos tempos". Ainda mais depois de um REM, você precisa de um espaço, depois de :: você não precisa.

E como dito no primeiro comentário: você pode adicionar informações a qualquer linha que achar necessário

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

Quanto ao salto de peças. Colocar o REM na frente de cada linha pode consumir bastante tempo. Como mencionado, usar o GOTO para ignorar partes é uma maneira fácil de ignorar grandes partes de código. Certifique-se de definir um: LABEL no ponto em que deseja que o código continue.

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

Comentários em várias linhas

Se houver um grande número de linhas que você deseja comentar, será melhor se você puder fazer comentários com várias linhas em vez de comentar todas as linhas.

Veja este post de Rob van der Woude nos blocos de comentários :

O idioma do lote não possui blocos de comentários, embora haja maneiras de obter o efeito.

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

Você pode usar GOTORótulo e: Rótulo para fazer comentários em bloco.

Ou, se o bloco de comentários aparecer no final do arquivo em lotes, você poderá escrever EXITno final do código e, em seguida, qualquer número de comentários para sua compreensão.

@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...

Colocando comentários na mesma linha com os comandos: use & :: comment

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

Explicação:

&separa dois comandos , portanto, neste caso, color Cé o primeiro comando e :: set red font coloro segundo.

Importante:

Esta declaração com comentário parece intuitivamente correta:

goto error1         :: handling the error

mas não é um uso válido do comentário. Funciona apenas porque gotoignora todos os argumentos anteriores ao primeiro. A prova é fácil, isso gototambém não falhará:

goto error1 handling the error

Mas tentativa semelhante

color 17            :: grey on blue

falha de executar o comando devido a 4 argumentos desconhecido para o colorcomando: ::, grey, on, blue.

Funcionará apenas como:

color 17     &      :: grey on blue

Portanto, o e comercial é inevitável.

Você pode comentar algo usando ::ou REM:

your commands here
:: commenttttttttttt

ou

your commands here
REM  commenttttttttttt

Para fazer isso na mesma linha que um comando, você deve adicionar um e comercial:

your commands here      & ::  commenttttttttttt

ou

your commands here      & REM  commenttttttttttt

Nota:

• Usar :: na lógica aninhada ( IF-ELSE, FORloops, etc ...) causará um erro. Nesses casos, use em REMvez disso.

Este é um tópico antigo e gostaria de adicionar meu entendimento aqui para expandir o conhecimento deste tópico interessante.

A principal diferença entre REM e :: é:

REM é um comando em si, enquanto :: não é.

Podemos tratar :: como um token que, assim que o analisador CMD encontrar o primeiro espaço não em branco de uma linha, é este :: token, ele simplesmente ignorará a linha inteira e lerá a próxima linha. É por isso que o REM deve ser seguido por pelo menos um espaço em branco para poder funcionar como um comentário para a linha, enquanto :: não precisa de nenhum espaço em branco atrás dela.

Que REM é um comando em si pode ser melhor entendido a partir da seguinte sintaxe FOR

A sintaxe básica do FOR é a seguinte

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

aqui <Command>pode haver qualquer comando válido. Assim, podemos escrever a seguinte linha de comando válida, como remé um comando

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

No entanto, NÃO PODEMOS escrever a seguinte linha, pois isso ::não é um comando

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

Você pode adicionar comentários ao final de um arquivo em lotes com esta sintaxe:

@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

Apenas certifique-se de nunca usar parênteses de fechamento.

Atribuições: Leo Guttirez Ramirez em https://www.robvanderwoude.com/comments.php