상담 신청
홈 › 작업 노트 › 개발 › 비주얼 스튜디오 디버거로 변수 값 추적하기

개발 · 도구 다루기

비주얼 스튜디오 디버거로 변수 값 추적하기

캐릭터 체력이 분명히 100이어야 하는데 전투가 끝나고 보면 음수가 되어 있습니다. 코드 곳곳에 출력문을 넣어 숫자를 찍다 보면 화면이 로그로 가득 차고, 정작 어디서 바뀌었는지는 놓칩니다. 비주얼 스튜디오 디버거를 쓰면 프로그램을 원하는 줄에서 멈춰 세우고 그 순간의 값을 직접 들여다볼 수 있습니다.

작업 노트 407 · 읽는 시간 약 5분 · 2026.11.17 정리

디버거를 쓰는 목적: 멈추고, 보고, 한 걸음씩

디버거가 하는 일은 세 가지로 요약됩니다. 원하는 줄에서 프로그램을 멈추고, 그 순간 변수에 들어 있는 값을 보여 주고, 한 줄씩 앞으로 진행시키며 값이 어떻게 변하는지 따라가게 해 줍니다. 출력문은 내가 미리 찍기로 정한 값만 보여 주지만, 디버거는 멈춘 순간 접근할 수 있는 거의 모든 값을 보여 줍니다. 무엇을 찍어야 할지 모를 때 특히 강합니다.

디버거를 쓰려면 디버그 구성으로 빌드해야 합니다. 릴리스 구성은 속도를 위해 코드를 최적화하면서 변수가 사라지거나 줄 순서가 바뀌기도 해서, 멈춰도 값이 이상하게 보이거나 중단점이 잡히지 않을 수 있습니다. 화면 위쪽 구성 선택에서 Debug가 선택되어 있는지 먼저 확인합니다. 메뉴 위치와 이름은 버전에 따라 조금씩 다를 수 있습니다.

실행도 디버깅 모드로 해야 합니다. F5로 시작하면 디버거가 붙은 상태로 실행되고, 디버깅하지 않고 시작하는 메뉴로 실행하면 중단점이 무시됩니다. 중단점을 걸었는데 멈추지 않는다면 이 두 가지, 빌드 구성과 실행 방식부터 확인하는 것이 가장 빠릅니다.

중단점을 걸고 값을 들여다보는 순서

  1. 의심되는 줄 왼쪽 여백을 클릭하거나 F9를 눌러 빨간 점으로 중단점을 건다.
  2. F5로 디버깅을 시작하고, 해당 줄에 도달해 멈출 때까지 게임을 진행한다.
  3. 멈춘 상태에서 변수 이름 위에 마우스를 올려 현재 값을 확인한다.
  4. 지역 창에서 현재 함수 안의 변수들을, 조사식 창에서 직접 지정한 값을 함께 본다.
  5. F10으로 한 줄씩 넘기며 값이 바뀌는 순간을 찾는다.

중단점은 문제가 드러나는 곳보다 조금 앞에 거는 편이 좋습니다. 체력이 음수로 보이는 줄에 걸면 이미 바뀐 뒤라 원인을 놓칩니다. 체력을 깎는 함수의 첫 줄에 걸고, 들어올 때의 값과 나갈 때의 값을 비교합니다. 들어올 때 이미 이상하다면 그 함수를 부른 쪽으로 거슬러 올라가야 합니다.

조사식 창에는 변수 이름뿐 아니라 간단한 식도 적을 수 있습니다. 플레이어 체력과 받은 피해를 함께 적어 두거나, 배열의 특정 칸을 지정해 두면 한 줄씩 넘길 때마다 원하는 값만 모아서 볼 수 있습니다. 구조체나 클래스는 펼쳐서 안쪽 멤버까지 볼 수 있어, 몬스터 하나의 상태 전체를 한눈에 확인하기 좋습니다.

게임프로그래밍 수업에서 다루는 작업 예시
게임프로그래밍 수업에서 다루는 작업 예시

한 줄씩 넘길 때 고르는 세 가지 방식

한 줄씩 진행하는 방법은 세 가지를 구분해 씁니다. F10은 현재 줄을 실행하고 다음 줄로 넘어가는데, 그 줄에 함수 호출이 있으면 함수 안으로 들어가지 않고 결과만 받고 지나갑니다. F11은 함수 호출이 있으면 그 함수 안의 첫 줄로 들어갑니다. Shift와 F11을 함께 누르면 지금 있는 함수를 끝까지 실행하고 부른 쪽으로 돌아옵니다.

처음 배우는 사람이 흔히 겪는 일은 F11만 계속 누르다가 표준 라이브러리나 엔진 내부 코드 깊숙이 들어가 길을 잃는 것입니다. 내가 짠 함수는 F11로 들어가고, 이미 믿을 수 있는 함수는 F10으로 건너뛰는 것이 기본입니다. 실수로 깊이 들어갔다면 Shift와 F11로 빠져나오면 됩니다.

호출 스택 창은 지금 멈춘 함수가 어떤 경로로 불렸는지 보여 줍니다. 맨 위가 현재 함수이고 아래로 갈수록 이 함수를 부른 함수들입니다. 체력을 깎는 함수가 예상치 못한 곳에서 불렸다면 여기서 바로 드러납니다. 목록에서 아래 줄을 더블클릭하면 그 시점의 위치와 변수 값으로 이동해 볼 수 있어, 부른 쪽에서 무엇을 넘겼는지 확인할 수 있습니다.

게임 코드에서 특히 쓸모 있는 조건부 중단점

게임 코드는 매 프레임 같은 함수가 수십 번씩 불립니다. 갱신 함수에 그냥 중단점을 걸면 매 프레임마다 멈춰서 원하는 순간까지 가기 어렵습니다. 이럴 때 중단점에 조건을 붙입니다. 중단점에 마우스 오른쪽 버튼을 눌러 조건을 지정하면, 예를 들어 체력이 0보다 작아질 때만 멈추게 할 수 있습니다. 수많은 호출 중 문제 순간 하나만 잡아낼 수 있습니다.

몬스터가 여러 마리일 때는 특정 개체에서만 멈추게 하는 조건도 유용합니다. 몬스터 번호나 이름을 조건에 넣으면 문제를 일으키는 그 한 마리만 추적할 수 있습니다. 조건 대신 지나갈 때마다 메시지를 출력하고 멈추지는 않게 하는 설정도 있어서, 코드에 출력문을 넣지 않고도 로그를 남길 수 있습니다.

C++에서는 특정 변수의 값이 바뀌는 순간 멈추게 하는 기능도 쓸 수 있습니다. 누가 이 값을 바꾸는지 도저히 모를 때 효과가 큽니다. 다만 변수의 메모리 위치를 기준으로 동작하기 때문에 그 변수가 살아 있는 동안만 의미가 있습니다. 엔진 스크립트처럼 다른 환경에서는 지원 범위가 다를 수 있으니 기능 설명을 확인하고 씁니다.

게임프로그래밍 과정에서 만드는 결과물 예시
게임프로그래밍 과정에서 만드는 결과물 예시

자주 하는 실수와 습관 만들기

  • 릴리스 구성으로 빌드해 놓고 중단점이 안 걸린다고 헤매는 경우
  • 중단점에서 멈춘 채 오래 두어 게임의 시간 계산이 크게 튀는 경우
  • 값을 확인한 뒤 원인을 적지 않아 같은 추적을 다음 날 또 하는 경우
  • 디버깅이 끝난 뒤 불필요한 중단점을 지우지 않아 엉뚱한 곳에서 멈추는 경우

두 번째 항목은 게임에서 특히 흔합니다. 중단점에서 몇 분 머물다 다시 진행하면 그 사이 흐른 시간이 한 프레임에 한꺼번에 계산되어 캐릭터가 순간 이동하기도 합니다. 이 현상을 새 버그로 착각하지 않도록, 디버깅 중에는 프레임 시간에 최댓값을 두는 처리를 해 두면 편합니다. 버그를 찾은 뒤에는 원인과 고친 방법을 짧게 기록하는 습관을 들입니다.

에러를 혼자 추적하는 습관은 처음부터 함께 들여야 오래갑니다. 디버거 사용이 아직 낯설어 코드가 멈출 때마다 막막하다면, SBS아카데미게임학원 게임프로그래밍 과정 무료 상담에서 지금 막힌 코드를 보여 주고 추적 순서부터 함께 짚어 보세요.

자주 묻는 질문

Unity C# 스크립트도 비주얼 스튜디오 디버거로 볼 수 있나요?

Unity 에디터에 디버거를 연결해 중단점과 변수 확인을 할 수 있습니다. 연결 방법은 Unity와 비주얼 스튜디오 버전에 따라 조금씩 달라 공식 안내를 확인하는 편이 정확합니다.

출력문으로 찍는 방법은 이제 쓰지 않아도 되나요?

여전히 씁니다. 오랜 시간 흐름을 기록하거나 멈추면 재현이 안 되는 문제에는 로그가 낫습니다. 두 방법을 상황에 맞게 섞어 쓰는 것이 좋습니다.

확인한 자료

외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

게임프로그래밍 수업 예시
이 글과 이어지는 과정게임프로그래밍 과정 안내

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청