LSP 진단 — 입력하는 동안 코드 검사

LSP 진단 — 입력하는 동안 코드를 검사한다

글을 쓸 때 맞춤법 검사기를 떠올려 보세요. 코드에도 그런 게 있다면? 바로 LSP 진단입니다.

LSP가 뭐예요?

LSP는 Language Server Protocol의 약자예요. 코드 편집기가 대화하는 뒤편의 도우미라고 생각하면 돼요. 코드를 입력하면 편집기가 언어 서버에 코드를 보내고, 서버는 오류를 검사해서 제안을 돌려줘요. 그 결과가 빨간 물결선, 노란 경고, 또는 작은 전구 아이콘으로 보이는 거예요.

Hermes Agent에서는 LSP를 사용해서 코드를 작성하는 동안 즉각적인 피드백을 제공해요. 별도로 “검사” 명령을 실행할 필요가 없죠. 마치 경험 많은 선배 개발자가 어깨너머로 지켜보면서 파일을 저장하기도 전에 오타와 논리 오류를 짚어주는 것과 같아요.

초보자가 왜 신경 써야 하나요?

LSP가 내부적으로 어떻게 동작하는지 알 필요는 없어요. 하지만 다음은 알아두는 게 좋아요:

단순한 실수를 바로 잡아줘요 (괄호 누락, 잘못된 변수 이름 등).
하면서 배우게 해줘요 — 물결선 위에 마우스를 올리면 문제와 해결 방법이 보여요.
시간을 절약해줘요 — 문제가 생긴 직후에 고치니까, 긴 디버깅 세션 후에 고생할 일이 없어요.

Hermes Agent에서 LSP 진단 사용하는 방법

Hermes Agent에는 LSP 지원이 내장되어 있어요. 시작하는 방법은 다음과 같아요:

1. 프로젝트 열기

코드가 있는 폴더에 있는지 확인하세요. 터미널에서:

cd my-project

2. Hermes Agent의 편집기 통합 시작하기

다음 명령을 실행하세요 (또는 편집기의 단축키를 사용하세요):

hermes lsp start

이제 .py, .js, .ts, .go 파일을 열면 진단 결과가 자동으로 표시돼요.

3. 진단 패널 읽기

대부분의 편집기에서 다음 키를 누르세요:

Ctrl+Shift+M   (Windows/Linux)
Cmd+Shift+M    (Mac)

그러면 “문제(Problems)” 패널이 열려요. 파일 이름, 줄 번호, 간단한 설명과 함께 모든 문제가 나열돼요.

4. 빠른 수정 적용하기

물결선 위를 클릭하면 작은 팝업이 나타나요. “빠른 수정(Quick Fix)“을 선택하거나 다음 키를 누르세요:

Ctrl+.   (Windows/Linux)
Cmd+.    (Mac)

Hermes Agent가 수정안을 제안할 거예요 — 보통 키 하나만 누르면 적용돼요.

기호는 무슨 뜻인가요?

빨간 밑줄 = 오류. 확실히 뭔가 잘못됐다는 뜻이에요 (예: 정의되지 않은 함수).
노란 밑줄 = 경고. 치명적이진 않지만 버그일 가능성이 높아요 (예: 사용하지 않는 변수).
파란색/전구 = 제안. 선택적인 개선 사항이에요 (예: 이 코드를 더 간단하게).

실제 예시

Python에서 이런 코드를 입력한다고 해볼게요:

def greet(name):
    print("Hello, " + nam)

nam — 오타가 보이죠? LSP가 빨간색으로 밑줄을 그을 거예요. 마우스를 올리면 다음과 같이 표시돼요:

"nam" 이름이 정의되지 않았습니다. "name"을(를) 의미했나요?

빠른 수정을 클릭하면 자동으로 name으로 바뀌어요. 크래시를 방지한 거예요.

흔한 함정 (그리고 피하는 방법)

경고를 무시하지 마세요 — 미래의 버그를 가리키는 경우가 많아요.
패널을 주기적으로 확인하세요 — 현재 줄만 보지 말고요.
“LSP 서버를 찾을 수 없음”이 표시되면 — hermes lsp start를 실행했는지, 파일 형식이 지원되는지 확인하세요.

요약 및 실용 팁

LSP 진단은 실시간 피드백을 제공해서 코딩을 추측 게임이 아니라 대화처럼 느끼게 해줘요. 쓰고, 도구가 알려주고, 고치고 — 그게 전부예요.

실용 팁: 코드를 실행하기 전에 항상 문제(Problems) 패널을 한 번 훑어보세요. 한 번의 빠른 확인으로 “왜 이게 안 되지?“라는 10분의 디버깅을 아낄 수 있어요. 습관으로 만들어 보세요 — 미래의 당신이 고마워할 거예요.

이제 코드를 작성하러 가보세요. 물결선이 안내해 줄 테니까요.