프로젝트

0. 프로젝트 초기 설정 : 컨벤션 규칙 지키기

Ofglen 2023. 7. 16. 18:42

 

코딩 컨벤션

코딩 컨벤션은 가독성이 좋고 관리하기 쉬운 코드를 작성하기 위한 코딩 스타일 규칙이다. 오류를 발생시키는 오류를 줄어주어서 유지보수 비용(시간)을 줄일 수 있다.

 

 

Checkstyle

지정된 코딩 컨벤션을 준수하는지 확인하는 도구이다.

Java 언어를 사용하여 웹 프로젝트를 개발하기 위해 초기 설정으로 구글 코딩 컨벤션을 Code Style Formatter로 설정하고 Checkstyle을 적용하는 과정을 정리했다.

 

 

 


1. 네이버 컨벤션 다운받기

아래 깃허브 주소에서 naver-intellij-formatter.xml 파일을 다운 받는다.

https://github.com/naver/hackday-conventions-java/blob/master/rule-config/naver-intellij-formatter.xml

 

Settings > Code Style - Schema 설정 > Import Schema > IntelliJ IDEA code Style XML을 선택하고, C 드라이브 아래에 다운 받은 naver-intellij-formatter.xml 파일을 선택하여 지정한다.

 

 

 

 

2. Java Tabs and Indents 설정

 

Settings > Code Style > Java

Google Style은 Tab size, Indent = 2로 설정되어 있으므로 4로 수정한다.

나는 네이버 컨벤션 규칙을 사용해서 다시 2, 2, 4로 변경했다.

 

 

 

 

 

3. Checkstyle 적용하기

naver-checkstyle-rules.xml과 naver-checkstyle-suppressions.xml를 다운로드 한다.

https://github.com/naver/hackday-conventions-java/blob/master/rule-config/naver-checkstyle-rules.xml

https://github.com/naver/hackday-conventions-java/blob/master/rule-config/naver-checkstyle-suppressions.xml

 

 

Settings > Plugins > CHECKStyle을 검색하고 설치 후 IntelliJ를 재부팅한다.

 

 

설치 후 Tools > Checkstyle

Scan Scope: All sources (including  tests)

Treat Checkstyle errors as warnings 체크박스를 선택한다.

Description: Naver Checkstype Rules로 지정한다. (권장)

 

 

 

Use a Local checkstyle File > Browse > naver-checkstyle-rules.xml 선택한다.

 

 

suppressionFile 프로퍼티 값으로 naver-checkstyle-suppressions.xml을 입력한다.

 

 

 

 

 

 

4. 저장 시 코딩 컨벤션 자동 적용 설정하기

설정창에서 save를 검색한다.

Actions on Save > Reformat code, Optimize import 체크박스를 선택한다.