라이브 코딩 혹은 강의를 하게된 개발자를 위한 intellij 개발 발표 세팅 팁

 

서론 

제가 졸업한 충남대 컴퓨터공학과에 현직 개발자분들이 2~3주간 돌아가며  회사에서 어떤 식으로 코딩을 하는지 맛보기 형태로 진행하는 실전코딩이라는 수업이 있습니다.

 원래 라이엇 게임즈에서 오셨지만 지금은 해당 강의를 들었던 학생들이 졸업 선배로서 강단에서 후배들에게 알려주게 되었습니다. 저는 작년과 올해 두 번 초청이 되어 후배님들과 수업을 진행할 수 있었습니다. 

 

 수업은 욕심이라고 생각될 정도로 많은 내용을 담고 있습니다. Git, 스프링, MSA, TDD, CI/CD, React 등 다양한 내용을 진행하는데 저는 작년에 스프링과 MSA, 올해는 서버 테스팅에 대해 강의를 진행했었습니다.

 

 늘 이상과 현실은 다릅니다. 열심히 준비했고 주말에 후배를 불러 준비한 수업에 대한 시뮬레이션을 여러번 돌려봤지만 강단에 서서 50명이 넘는 처음 보는 학생들을 가르치는 건 장애물이 많았습니다.

 특히 학창 시절 수학 수업을 들었을 때처럼 처음엔 간단하고 당연한 시작이었지만 나도모르게 잠깐 딴생각으로 흐름을 놓치면 암호문들이 가득 찬 칠판이었던 그때의 제 표정을 제 앞의 프로그래밍 수업을 듣는 후배님들도 짓고 있었거든요.

 

 다수를 대상으로하는 수업이다 보니 수업을 못 따라왔을 때 하나하나 다 케어해 주기가 너무 어려웠습니다. 특히 학생 입장에서 잠깐 주의를 잃게 되면 어느 파일에서 코딩을 하고 있는지를 놓치는 경우가 많았습니다.  스프링 같은 모듈화와 추상화가 높은 프레임워크는 여러 파일에서 코딩이 진행되어 더 헷갈렸습니다. 그나마 하나의 파일에서 Bean 형태로 작성한 후 클래스를 나눠서 Controller - Service - Repository로 구성해 보는 식으로 진행을 했지만 TDD 같은 더 큰 추상화가 요구되는 강의에선 모듈을 분리하는 게 핵심 개념이기 때문에 여러 개의 파일을 왔다 갔다 해서 더욱 학생들이 헷갈렸을 것입니다.

 

 이런 경험을 통해 학생 입장에서 강사가 어디를 코딩하고 있는지 어떤 명령어를 치고 있는지 각인시킬 수 있는 방법들이 굉장히 중요하다는 걸 알았습니다. 결국 가시성이 제일 중요합니다

찾아봤을 때 이런 세팅에 대한 글이 거의 없어서 제가 찾아보고 발표에 썼던 세팅들과 팁을 공유하겠습니다.

 

발표 진행은 intellij ultimate 최신판과 java17, mac에서 진행했고 강의 전에 intellij 최신판 설치를 공지했습니다

 

한글판과 영어판문구가 다르다보니 검색으로 찾아가는게 어려워질 수 있어서 한글판에서도 찾을 수 있도록 설정 위치를 확인하면서 적었습니다. intellij 가 업데이트가 잦아 간혹 설정 위치나 문구가 바뀔 때도 있습니다. 혹시 버전이 달라 해당위치에 설정이 없다면 intellij 세팅 + 키워드로 검색해보시는 걸 추천드립니다 

 

발표당시 intellij 최신버전이 2023.2.x 였는데 글을 마무리할 당시 intellij ultimate 2023.3.x 으로 변경되어 마이그레이션을 하며 진행했습니다.

---

플러그인 설치 방법

File > Settings ([ctrl+alt+s] / [cmd+,]) > 플러그인에서 검색 후 설치 

 

intellij 편의성/단축키 설정

File > Settings > Keymap, 원하는 메뉴 검색 혹은 vim등 다른 앱의 keymap으로 단축키 설정 가능 

 

---

프로젝트 세팅 오류시 

gradle 빌드 설정 (2023.2.x 버전 이하)

설정 > Build, Execution, Deployment > Build Tools > Gradle > Gradle JVM  버전 확인

 

프로젝트가 실행이 되지 않는 이유 중에 대표적인 하나가 프로젝트랑 시스템 자바 버전이 맞지 않는 경우입니다. 아래와 같은 오류 메시지가 뜹니다. 꽤 흔한 많은 경우여서 프로젝트 시작전에 다같이 한번 체크하고 시작하는 걸 추천 드립니다. 

2023.3.x 버전에서는 해당 부분이 사라졌는데 빌드도구 업데이트로 자동 세팅이 되는 것 같다 

 

mvn 빌드 설정 

Settings > Build, Execution, Deployment > Build Tools > Maven > Importing 에서 JDK for import 에서 설정

---

단축키 보여주기: presentation assistant

라이브 코딩을 하다보면 습관처럼 단축키를 누르는 경우가 많은데 이렇게되면 전환 속도가 너무 빨라 학생들은 거의 대부분 진도를 놓치게 된다. 이럴 경우 강사가 누른 단축키가 아래 나온다면 강사가 어떤 키를 누르는지 학생들도 인지할 수 있고 강사도 내가 누른 단축키를 학생들에게 자연스럽게 인지하고 알려주면서 수업을 진행할 수 있습니다. 

이 기능을 켜놓으면 마우스로 하던 기능에 대해 단축키를 자연스럽게 습득하기도 편해서 처음 intellij 제품을 접하는 분들은 켜놓고 코딩하는 것도 추천한다. 

 

2023.2.x 버전 이하에선 Presentation Assistant 라는 플러그인을 통해 설치해서 사용했다.

이 기능이 2023.3.x 버전부터는 기본 기능으로 편입 되어 더 편리하게 쓸 수 있게 되었다 

https://www.jetbrains.com/help/idea/presentation-assistant.html

Presentation Assistant | IntelliJ IDEA

 

View > Appearance > Presentation Assistant

https://github.com/chashnikov/IntelliJ-presentation-assistant/issues/59#issuecomment-1851784814

plugin 이름도 for 2023.2 가 뒤에 붙고 2023.3 에서는 쓰지 못하도록 가이드하고 있습니다.

Not compatible with IntelliJ IDEA 2023.3 · Issue #59 · chashnikov/IntelliJ-presentation-assistant

---

화면 분할 설정 ( + 단축키에 추가)

발표를 하다보면 서로 다른 두개의 파일을 왔다갔다하는 것보다 한 화면에 보여주고 비교하면서 이야기하고 코딩 해야할 때가 있습니다. 

이럴 경우 파일을 열 때 우클릭 후 Open in right split 으로 분할해서 열어야합니다. 

매번 이렇게 해도 되지만 저는 안쓰는 단축키로 설정해서 사용합니다 

File > Keymap > 검색창(Open in right split) > 단축키 설정

 

---

Project view 현재 파일 위치 표시 

대부분 왼쪽에 Project view를 디폴트로 띄어놓습니다. 그리고 코드를 설명하다 보면 상단의 탭이나 단축키 등으로 파일을 왔다갔다 하는 경우가 생깁니다.  학생 입장에서 파일이 여러개다보면 자주 바뀌는 화면에 집중도도 떨어지고 흐름을 잃기 쉽습니다. 그럴 때 Project view 현재 파일 위치 표시를 해놓으면 파일을 이동했을 때 Project view도 강사가 보는 파일로 포커스가 되어주어 학생들이 진도를 따라오기 편해집니다.

 

 

---

스크롤로 글꼴 키우기/줄이기 (돋보기)

발표 중간에 글씨가 작아 잘 안보인다는 피드백을 받을 수 있고 중간 중간 시각적으로 강조할 수도 있어서 발표할 때 굉장히 유용하다. 이 설정이 안되어있으면 File > Settings > Editor > Font 에서 일일이 사이즈를 바꿔주면 된다 

File > Settings > Editor > General > Mouse controll > Change font size with Co~~ 를 선택해서 Command + 마우스휠 혹은 트랙패드 위 아래 로 빠르게 글씨크기를 조정할 수있다  

또 아래 디폴트 크기로 돌아갈 수 있는 팝업이 뜨기 때문에 작업이 끝나고 복구하기도 편하다 

---

UI 글자크기 바꾸기 

학생들은 인텔리제이 UI 가 익숙하지 않을 수 있다. 인텔리제이는 UI의 글씨크기도 조정할 수 있다 

File > Settings > Appearance & Behavior > Appearance > Use custom font 에서 Size 조절

 

---

추가 프로그램

마우스 강조 설정 / 프로그램

마우스를 크게해놓아야 강사가 말하고 있는 곳이 어느 코드에 위치하는지 빠르게 판단할 수 있습니다. 

https://support.apple.com/ko-kr/guide/mac-help/mchlp2920/mac

Mac에서 포인터 보기가 더 쉽도록 하기

mac 기본으로 설정을 할 수도 있지만 프로그램으로 효과를 더 주면 발표하면서 한번 씩 환기를 하는데도 유용하게 쓰입니다. 

 

화면분할 프로그램 

Rectangle (무료)

https://rectangleapp.com/

Rectangle

윈도우는 기본적으로 윈도우+방향키를 통해 다른 프로그램을 쉽게 화면분할을 할 수 있지만 mac은 기본기능에서 지원하지 않는다. 그러나 Rectangle을 사용하면 편하게 화면분할을 할 수가 있습니다.

---

추가로 글을 쓰면서 찾은 intellij 공식 유튜브에 올라온 프리젠테이션 세팅 영상이 있어서 공유드립니다. 겹치는 부분도 있고 단축키 부분도 있어서 참고해주세요

https://www.youtube.com/watch?v=h-HGg9b6Dqw

 

강의를 준비하면서 발표용 세팅에 대한 글을 찾기 어려워서 제 경험에 도움되었던 옵션들 위주로 정리해봤습니다. 혹시 발표할 때 유용했던 다른 옵션이나 앱이 있으면 댓글로 공유해주시면 저도 배우겠습니다