[batch-file] 배치 파일에 어떤 주석 스타일을 사용해야합니까?

이 답변은이 페이지의 많은 훌륭한 답변에 대한 실용적인 요약 을 시도합니다 .

^{jeb의 훌륭한 답변 은 실제로 심층적으로 진행되며 많은 경우를 다루기 때문에 특별한 언급이 필요합니다.
특히, 잘못 구성된 변수 / 파라미터 참조 는 아래의 라인을 포함하여 아래의 솔루션을 모두%~ 손상시킬 수REM 있다고 지적 합니다 .}

전체 주석-직접 지원되는 유일한 스타일 :

• REM(또는 그 변형) 유일한 공식 주석 구성 이며 가장 안전한 선택 입니다. Joey의 유용한 답변을 참조하십시오 .

• ::A (널리 사용되는)은 해킹 이, 장점과 단점은 :

  • 찬성 :

    • 시각적 특징 및 타이핑 용이성.
    • 속도 는 문제가되지 않지만 jeb의 훌륭한 답변 과 Rob van der Woude의 훌륭한 블로그 게시물을 참조하십시오 .

  • 단점 :

    • 내부 (...)블록, ::수 중단 명령을 하고, 안전한 사용을위한 규칙은 기억하기 쉽지 제한하고 있습니다 – 아래를 참조하십시오.

당신이 경우 않는 사용하려면:: , 당신이 선택할 수 있습니다

• 하나 : 안전을 위해, 내부 예외하게 (...)블록을하고 사용 REM이, 또는 장소 코멘트를하지 않는 내부 (...) 모두.
• 또는 : 내부의 안전한 사용을 위해 고통스럽고 제한적인 규칙을::(...) 기억하십시오 . 다음 스 니펫에 요약되어 있습니다.

@echo off

for %%i in ("dummy loop") do (

  :: This works: ONE comment line only, followed by a DIFFERENT, NONBLANK line.
  date /t

  REM If you followed a :: line directly with another one, the *2nd* one
  REM would generate a spurious "The system cannot find the drive specified."
  REM error message and potentially execute commands inside the comment.
  REM In the following - commented-out - example, file "out.txt" would be
  REM created (as an empty file), and the ECHO command would execute.
  REM   :: 1st line
  REM   :: 2nd line > out.txt & echo HERE

  REM NOTE: If :: were used in the 2 cases explained below, the FOR statement
  REM would *break altogether*, reporting:
  REM  1st case: "The syntax of the command is incorrect."
  REM  2nd case: ") was unexpected at this time."

  REM Because the next line is *blank*, :: would NOT work here.

  REM Because this is the *last line* in the block, :: would NOT work here.
)

다른 주석 스타일의 에뮬레이션 -인라인 및 멀티 라인 :

참고 이러한 스타일의 어느 것도 직접 배치 언어에 의해 지원되지 않습니다 할 수 있지만 에뮬레이트 .

인라인 코멘트 :

<sup>* 아래의 코드 스 니펫 ver은 실험을 용이하게하기 위해 임의의 명령에 대한 스탠드 인으로 사용 됩니다.
* SET인라인 주석으로 명령이 올바르게 작동하도록 하려면 name=value부품을 큰 따옴표로 묶으십시오 . 예를 들어, SET "foo=bar". [1]</sup>

이와 관련하여 우리는 두 가지 하위 유형을 구별 할 수 있습니다.

• EOL 주석 ([to-the-]-end-of-line])은 명령 뒤에 배치 될 수 있으며 줄 끝까지 계속 확장됩니다 (다시 말해서 jeb ‘s answer ).

  • ver & REM <comment>REM유효한 명령 이라는 사실을 &이용하며 기존 명령 뒤에 추가 명령을 배치하는 데 사용할 수 있습니다.
  • ver & :: <comment>그것의 안전한 사용은 독립형을 사용하는 것보다 훨씬 제한적이기 때문에 실제로(...) 작동하지만 블록 외부에서만 사용할 수:: 있습니다.

• 인라인 주석-한 줄의 여러 명령 사이 에 또는 주어진 명령 내부 에 이상적으로 배치 됩니다.
  인라인 주석은 가장 유연한 (단일 라인) 양식이며 정의에 따라 EOL 주석으로도 사용될 수 있습니다.

  • ver & REM^. ^<comment^> & ver수 주석 삽입 명령 사이에 (다시,의 호의 젭의 대답 )하지만, 참고 방법 <및 >필요하기 ^때문에, 적어 주며을 문자를 다음과 같습니다. : 그대로 사용할 수 없다< > | (이스케이프 반면 &하거나 &&또는 ||개시 다음 명령).

  • %= <comment> =%dbenham의 훌륭한 답변 에서 자세히 설명 했듯이 , 가장 유연한 형식 은 명령 내 에서 (논쟁 중) 배치 될 수 있기 때문 입니다.
    그것은 방식으로 가변 확장 구문을 활용하는 표현은 항상로 확장되도록 빈 문자열 – 주석 텍스트가 둘 다 포함하지 않는 긴만큼 %나:
    처럼 REM, %= <comment> =%물론 외부와 내부 모두 작동 (...)블록을하지만 시각적 특징입니다; 유일한 단점은 타이핑하기가 어렵고 문법적으로 잘못되기 쉽고 널리 알려지지 않았기 때문에 기술을 사용하는 소스 코드의 이해를 방해 할 수 있다는 것입니다.

여러 줄 (전체 줄) 주석 :

• James K의 답변 은 goto문장과 레이블 을 사용하여 임의 길이와 내용의 여러 줄 주석을 구분하는 방법을 보여줍니다 (이 경우 사용 정보를 저장하는 데 사용).

• Zee의 답변 은 “널 레이블” 을 사용하여 여러 줄 주석을 만드는 방법을 보여 주지만 모든 내부 줄을로 종료하려면주의를 기울여야합니다 ^.

• Woude의 블로그 게시물 데르 롭 밴은 당신이 할 수 있습니다 다른 다소 모호한 옵션 언급 종료 주석 행의 임의의 수의 파일을 :의 개방 (에만 무시 다음에 오는 모든 원인 으로 오래가 포함되어 있지 않기 때문에, (비를 ^-escaped) ), 즉, 한 블록이되지 않으므로 폐쇄 .

^{[1] 사용하여 SET "foo=bar"이름과 주위에 따옴표를 넣어, – 즉, 변수를 정의 =하고 값을 결합하는 -과 같은 명령에 필요한 SET "foo=bar" & REM Set foo to bar.어떤 것을 보장하기 위해 그렇게으로, 다음 (가)이 경우, 다음 명령에 변수 값 (최대 의도 단일 공간)이 우연히 그 일부가되지는 않습니다.
(제쳐두고 : SET foo="bar"문제를 피할뿐만 아니라 큰 따옴표를 값의 일부로 만듭니다 ).
이 문제는 값을 따르는 우발적 인 후행 공백에 내재되어 SET있으며 심지어 적용 되기 때문에 항상 접근 방식을 사용하는 것이 좋습니다 .SET "foo=bar"}

답변

echo this will show until the next REM &REM this will not show

::(^
this is a multiline^
comment... inside a null label!^
dont forget the ^caret at the end-of-line^
to assure continuity of text^
)