STM32CubeIDE에서 한글 주석 사용하는 방법

임베디드 개발을 하다 보면

코드에 한글 주석을

남겨야 할 일이 꽤 많습니다.

특히 협업 시에는

설명을 한글로 남겨두는 게

훨씬 효율적이죠.

그런데 STM32CubeIDE에서

한글이 깨지거나 물음표로 보이거나,

아예 빈칸으로 나오는 경험

다들 한 번쯤은 해보셨을 겁니다.

처음 STM32CubeIDE를 사용할 때,

주석이 깨져서 엄청 당황했던

기억이 납니다.

"왜 한글이 안 써지지?"

하고 검색을 해도,

정확한 해결 방법이 정리된 자료는

많지 않더라고요.

그래서 오늘은 STM32CubeIDE 환경에서

한글 주석을 제대로 작성하고

표시하는 방법을

정리해보려고 합니다.

IDE 내부 설정부터

윈도우 시스템 환경변수까지,

한 번 설정해 두면

두고두고 편하게 쓸 수 있는 꿀팁이니

꼭 따라 해 보세요!

한글 주석이 깨지는 이유

STM32CubeIDE는 기본적으로

UTF-8 인코딩을 사용하도록

설정되어 있습니다.

하지만 다음과 같은 상황에서는

한글이 깨질 수 있습니다.

• 프로젝트 생성 시 인코딩 설정이 다르게 지정된 경우
• 외부에서 가져온 파일이 ANSI, EUC-KR 등 다른 인코딩 형식일 경우
• 운영체제 환경변수 설정에 UTF-8이 누락된 경우

즉, 이클립스 기반 설정 + 시스템 환경변수를

모두 체크해야 완벽하게 해결됩니다.

Step 1: 기본 인코딩 설정 (UTF-8)

1. 상단 메뉴에서
   Window → Preferences로 이동
2. General → Content Types 선택
3. 하단의 Default encoding 항목에 UTF-8 입력
4. Update → Apply and Close 클릭

STM32CubeIDE 환경 설정

STM32CubeIDE 환경 설정

이렇게 하면 IDE 전역의

기본 인코딩이 UTF-8로 설정되어

대부분의 파일에서

한글이 깨지지 않게 됩니다.

Step 2: 윈도우 환경 변수 설정 (JAVA_TOOL_OPTIONS)

위의 설정을 적용해도

여전히 한글이 깨진다면,

이는 JVM(Java Virtual Machine)의

기본 인코딩이 시스템 인코딩을

따르지 않기 때문일 수 있습니다.

특히 한국어 윈도우는

EUC-KR이 기본이라

충돌이 발생할 수 있어요.

이때는 환경 변수에

강제로 UTF-8을

지정해 주는 방법이

효과적입니다.

시스템 환경 변수 설정

사용자 변수 편집

1. 윈도우 검색창에 “시스템 환경 변수 편집” 입력 후 실행
2. 환경 변수(N) 버튼 클릭
3. 사용자 변수 또는 시스템 변수 항목에서 새로 만들기 클릭
4. 아래와 같이 입력
   • 변수 이름: JAVA_TOOL_OPTIONS
   • 변수 값: -Dfile.encoding=UTF-8
    
5. 저장 후 시스템 재부팅

만약 사용자 변수로

설정해도 안 된다면,

시스템 변수 항목에도

동일하게 추가해 보세요.

보안 정책이나 시스템 설정에 따라

시스템 변수 우선 적용이

필요할 수 있습니다.

한글 주석 예시

환경 설정이 완료되었다면

이제부터는 자유롭게

한글 주석을 작성할 수 있어요.

// 한 줄 주석: 예) 초기화 완료
/* 여러 줄 주석:
   센서 값 읽기 및 출력 처리
*/

코드 내 설명을 한글로 남길 수 있다면

협업과 유지보수 측면에서도

훨씬 효율적인 코드가 됩니다.

 

 

이것만 해두면,

앞으로 STM32CubeIDE에서

한글 주석을 아무 걱정 없이

사용할 수 있습니다.

혹시 이 설정을 했는데도

문제가 발생한다면,

같은 프로젝트 내 .c 파일을

메모장 등에서 열어보고

인코딩을 수동으로

확인해 보는 것도 좋습니다.

모든 파일이 UTF-8로

저장되어야 완벽하게 동작하니까요.

앞으로는 더 깔끔한 코드와

더 정확한 주석 작성으로,

임베디드 개발이 한층 더 즐거워지시길 바랍니다.