JSP 코드 자동 정렬 단축키와 포맷 설정으로 가독성 높이기

JSP 코드 자동 정렬 단축키와 포맷 설정으로 가독성 높이기

JSP 파일은 Java와 HTML, 그리고 JSTL 태그가 함께 존재하는 구조입니다.

이 때문에 들여쓰기나 줄 맞춤이 흐트러지면 가독성이 급격히 떨어지고,

버그의 원인도 찾기 어려워집니다.

오늘은 초보 개발자도 바로 활용할 수 있는 JSP 자동 정렬 단축키와 포맷 설정법을

단계별로 정리해드릴게요.

 

 

 

1. JSP 코드가 복잡해지는 이유

JSP는 단순한 HTML 템플릿이 아닙니다. 그 안에는 Java 로직, JSTL, EL(Expression Language),

CSS, JavaScript까지 섞여 있습니다. 이 구조가 바로 JSP 코드가 한눈에 보기 어렵게 되는 원인입니다.

 

코드가 정돈되지 않으면 서버에서 오류를 찾기도 어렵고, HTML 태그와 JSTL 태그가 꼬이는 현상도

자주 발생합니다. 이럴 때 필요한 것이 바로 **자동 정렬 기능(Format Code)** 입니다.

 

2. Eclipse에서 JSP 자동 정렬 단축키

대부분의 JSP 파일은 Eclipse IDE에서 관리합니다. Eclipse에서는 다음 단축키로 손쉽게 코드를

자동 정렬할 수 있습니다.

• Ctrl + Shift + F : 전체 코드 자동 정렬 (HTML + JSP 포함)
• Ctrl + I : 현재 줄만 들여쓰기 재정렬

만약 자동 정렬이 제대로 동작하지 않는다면, Window → Preferences → Web → HTML Files → Editor 메뉴에서

Indent using spaces와 Indentation size: 4로 설정해보세요. 이 옵션은 HTML 태그와 JSP 태그의

계층 구조를 명확히 보여줍니다.

 

3. JSP 포맷 설정 커스터마이징

Eclipse에서는 프로젝트별로 코드 포맷터(Code Formatter)를 따로 지정할 수 있습니다.

이 기능을 사용하면 팀의 스타일 가이드를 반영하거나, HTML과 Java 코드의 정렬 방식을 맞출 수 있습니다.

1. Window → Preferences → Java → Code Style → Formatter 클릭
2. “New…” 버튼을 눌러 새로운 포맷터 프로파일 생성
3. HTML 태그 들여쓰기, 공백 규칙, 줄 바꿈 방식 설정
4. “Apply and Close” 버튼으로 저장

이 설정을 한 번만 해두면, 이후 모든 JSP 파일에서 동일한 포맷이 적용됩니다.

특히 <%= %> 표현식과 JSTL 태그가 균일한 들여쓰기를 가지게 되어 훨씬 읽기 쉬워집니다.

4. 협업 환경에서의 JSP 포맷팅 팁

팀 단위 개발에서는 Formatter XML 파일을 공유하는 것이 좋습니다. Eclipse에서는 Export 기능을 통해

Formatter 설정을 XML로 저장할 수 있으며, 이를 Git 리포지토리에 포함시켜 팀원 전원이 동일한 코딩 스타일을

유지할 수 있습니다.

또한 .editorconfig 파일을 병행하면 다른 IDE(VSCode 등)에서도 동일한 들여쓰기와 공백 규칙을

자동 적용할 수 있습니다.

 

5. JSP 코드 정렬 습관으로 완성하는 깔끔한 페이지

자동 정렬 단축키 하나로 코드가 깔끔해진다면,

당신의 JSP 페이지는 **디자인처럼 구조적으로 보이는 코드**가 됩니다.

깨끗한 들여쓰기, 의미 있는 공백, 규칙적인 주석은 곧 **프로젝트의 품질과 직결되는 신뢰성**이기도 합니다.

 

 

마무리

JSP 코드를 정리하는 일은 단순한 미관이 아니라, 프로페셔널한 개발 습관의 핵심입니다. 다음 글에서는 3일차로 “SQL 쿼리 정렬과 주석 달기 실전 가이드”를 다룰 예정입니다. 북마크해두고 함께 완성도 있는 코드를 만들어보세요!