주석

1. 템플릿 주석 구분

작성 방식	타입	특징
<!-- HTML 주석 -->	HTML 기본 주석	최종 웹페이지 소스코드에 출력되며 브라우저 소스 보기에서 확인 가능
## 한줄 주석	Velocity 한줄 주석	엔진만 인식하며 페이지에 출력되지 않음, 줄 끝까지 적용
#* 여러줄 주석 내용 *#	Velocity 여러줄 주석	줄바꿈 지원, 페이지에 출력되지 않음

개발 권장：업무 관련 코드 주석은 ## / #* *# 를 우선 사용하여 페이지 소스에 주석 내용이 노출되지 않도록 하세요.

2. 변수 명명 규칙

공식 기본 명명 규칙

1. 변수의 첫 글자는영문자(a‑z / A‑Z)여야 합니다
2. 이후 사용 가능 문자：영문자, 숫자0‑9, 밑줄_, 하이픈-

하이픈 - 의 연산자 모호성 문제

#set($name-d = "test")Code language: PHP (php)

실행 시 오류가 발생：Encountered "name" ... Was expecting one of:
원인：Velocity가 - 를 빼기 연산자로 인식하기 때문입니다!
엔진은 $name - d 로 해석하여 변수 $name 에서 변수 d 를 빼는 연산으로 판단해 문법 충돌이 생깁니다.

두 가지 해결방법：

1. 권장：밑줄을 사용한 명명 (모호성 없음, 일반적인 코딩 규약)

#set($name_d = "hello world")Code language: PHP (php)

2. 중괄호로 변수 범위 지정 (하이픈이 들어간 변수명 지원)

#set(${name-d} = "hello world")
${name-d}Code language: PHP (php)

유효/무효 예시 비교

# ✅정상
#set($name_d = "밑줄")
#set($name12d = "영문자 시작 + 숫자")
#set(${name-1_2d} = "하이픈 사용 시 중괄호 필수")

# ❌중괄호 없이 하이픈 사용 → 구문 분석 오류
#set($name-d = "오류 발생!")
#set($name-1_2d = "오류 발생!")Code language: PHP (php)

3. #set 문법 작성 규칙

표준 작성법 (괄호 주변 공백은 자유롭게, 통일된 스타일 권장)

#set($변수이름 = "값")Code language: PHP (php)

문자열은 큰따옴표로 감싸야 합니다. 등호 좌우에 공백을 넣으면 가독성이 좋아집니다.

주석