Mam plik wsadowy, który uruchamia kilka skryptów Python wykonujących modyfikacje tabeli.

1. Chcę, aby użytkownicy komentowali skrypty 1-2 Pythona, których nie chcą uruchamiać, zamiast usuwać je z pliku wsadowego (aby następny użytkownik wiedział, że te skrypty istnieją jako opcje!)

2. Chcę również dodać komentarze, aby zwrócić ich uwagę, w szczególności zmienne, które muszą zaktualizować w pliku wsadowym przed jego uruchomieniem. Widzę, że mogę użyć REM. Ale wygląda na to, że to więcej w przypadku aktualizacji użytkownika z postępem po jego uruchomieniu.

Czy istnieje składnia umożliwiająca bardziej odpowiednie dodawanie komentarza?

remPolecenie jest rzeczywiście dla komentarzy. Z natury nie aktualizuje nikogo po uruchomieniu skryptu. Niektórzy autorzy skryptów mogą jednak używać go w ten sposób echo, ponieważ domyślnie interpreter wsadowy wypisuje każde polecenie przed jego przetworzeniem. Ponieważ rempolecenia nic nie robią, można je bezpiecznie drukować bez skutków ubocznych. Aby uniknąć drukowania polecenia, poprzedź je znakiem @lub, aby zastosować to ustawienie w całym programie, uruchom @echo off. (Ma to na echo offcelu uniknięcie drukowania kolejnych poleceń; @ma to na celu uniknięcie drukowania tego polecenia przed wprowadzeniem ustawienia echa).

Tak więc w pliku wsadowym możesz użyć tego:

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

Użyj ::lubREM

::   commenttttttttttt
REM  commenttttttttttt

ALE (jak ludzie zauważyli):

• Jeśli używasz inline, musisz dodać &znak:
  your commands here & :: commenttttttttttt
• Wewnątrz zagnieżdżonej logiki ( IF/ELSE, FORpętli itp.) Użyj, REMponieważ ::daje błąd.
• :: może zawieść w ciągu setlocal ENABLEDELAYEDEXPANSION

Nie, zwykłe stare pliki wsadowe używają REMjako komentarza. ECHOto polecenie, które drukuje coś na ekranie.

Aby „skomentować” sekcje pliku, których możesz użyć GOTO. Przykład wszystkich tych poleceń / technik:

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

Co mogę powiedzieć? pliki wsadowe są reliktem dawno minionych czasów, są niezgrabne i brzydkie.

Możesz przeczytać więcej na tej stronie .

EDYCJA: zmodyfikowałem nieco przykład, aby zawierał elementy, których najwyraźniej szukasz.

:: zamiast REM najlepiej było używać w czasach, gdy komputery nie były bardzo szybkie. REM'ed linii są czytane, a następnie wprowadzane. :: 'ed linia jest całkowicie ignorowana. To może przyspieszyć twój kod w „dawnych czasach”. Ponadto po REM potrzebujesz spacji, po :: nie.

I jak powiedziano w pierwszym komentarzu: możesz dodać informacje do dowolnej linii, w której czujesz taką potrzebę

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

Jeśli chodzi o pomijanie części. Stawianie REM przed każdą linią może być czasochłonne. Jak wspomniano, używanie GOTO do pomijania części jest łatwym sposobem na pomijanie dużych fragmentów kodu. Pamiętaj, aby ustawić: LABEL w punkcie, w którym chcesz kontynuować kod.

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

Komentarze wieloliniowe

Jeśli istnieje duża liczba linii, które chcesz skomentować, lepiej będzie, jeśli będziesz mógł komentować wiele linii zamiast komentować każdą linię.

Zobacz ten post Roba van der Woude na temat bloków komentarzy :

Język wsadowy nie ma bloków komentarzy, choć istnieją sposoby na osiągnięcie tego efektu.

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

Do GOTOdodawania komentarzy do bloków można użyć opcji Etykieta i: Etykieta.

Lub, jeśli blok komentarza pojawia się na końcu pliku wsadowego, możesz napisać EXITna końcu kodu, a następnie dowolną liczbę komentarzy do zrozumienia.

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

Umieszczanie komentarzy w tym samym wierszu za pomocą poleceń: użyj & :: comment

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

Wyjaśnienie:

&rozdziela dwa polecenia , więc w tym przypadku color Cjest to pierwsze polecenie i :: set red font colordrugie.

Ważny:

To stwierdzenie z komentarzem wygląda intuicyjnie poprawnie:

goto error1         :: handling the error

ale to nie jest poprawne użycie komentarza. Działa tylko dlatego, że gotoignoruje wszystkie argumenty za pierwszym. Dowód jest prosty, to też gotonie zawiedzie:

goto error1 handling the error

Ale podobna próba

color 17            :: grey on blue

nie wykonaniem polecenia ze względu na nieznaną 4 argumenty do colorpolecenia: ::, grey, on, blue.

Będzie działać tylko jako:

color 17     &      :: grey on blue

Tak więc ampersand jest nieunikniony.

Możesz skomentować coś za pomocą ::lub REM:

your commands here
:: commenttttttttttt

lub

your commands here
REM  commenttttttttttt

Aby to zrobić w tym samym wierszu co polecenie, musisz dodać znak ampersand:

your commands here      & ::  commenttttttttttt

lub

your commands here      & REM  commenttttttttttt

Uwaga:

• Korzystanie :: z zagnieżdżonych logiki ( IF-ELSE, FORpętle, itp ...) spowoduje błąd. W takich przypadkach użyj REMzamiast tego.

To jest stary temat i chciałbym tutaj dodać moje zrozumienie, aby poszerzyć wiedzę na temat tego interesującego tematu.

Kluczowa różnica między REM a :: to:

REM to samo polecenie, podczas gdy :: NIE jest.

Możemy traktować :: jako token, który, gdy tylko parser CMD napotka pierwszą niepustą spację w linii, to :: token, po prostu pominie całą linię i przeczyta następną linię. Dlatego po REM powinien znajdować się co najmniej pusty spacja, aby mógł funkcjonować jako komentarz do linii, podczas gdy :: nie potrzebuje za nim spacji.

To, że REM jest poleceniem, można najlepiej zrozumieć na podstawie następującej składni FOR

Podstawowa składnia FOR jest następująca

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

tutaj <Command>może być dowolne prawidłowe polecenie. Możemy więc napisać następujący prawidłowy wiersz polecenia, tak jak rempolecenie

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

Nie możemy jednak napisać następującego wiersza, ponieważ ::nie jest to polecenie

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

Możesz dodać komentarze na końcu pliku wsadowego za pomocą następującej składni:

@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

Tylko upewnij się, że nigdy nie używasz zamykających nawiasów.

Uznanie autorstwa: Leo Guttirez Ramirez na https://www.robvanderwoude.com/comments.php