[중급] Dart 예외 처리 및 디버깅/ 디버깅 기법 및 로그 출력 방법

 

디버깅은 소프트웨어 개발에서 매우 중요한 과정입니다. 버그를 효과적으로 찾고 수정하는 능력은 고품질의 코드를 작성하는 데 필수적입니다.

Dart 언어에서는 다양한 디버깅 기법과 로그 출력 방법을 제공하여 개발자가 코드 문제를 빠르고 정확하게 해결할 수 있도록 돕습니다.

이 글에서는 Dart에서 사용할 수 있는 디버깅 기법과 로그 출력 방법에 대해 자세히 설명하겠습니다.

1. 디버깅 기법

1.1 디버거(Debugger) 사용하기

디버거는 코드 실행을 단계별로 추적하면서 변수의 상태를 확인하고, 중단점(Breakpoint)을 설정하여 프로그램의 흐름을 제어할 수 있게 해줍니다.

Dart에서는 IDE(통합 개발 환경)에서 디버거를 활용할 수 있습니다. 가장 많이 사용하는 IDE는 Visual Studio Code와 IntelliJ IDEA입니다.

• 중단점 설정: 디버거를 통해 코드의 특정 줄에 중단점을 설정할 수 있습니다. 중단점이 설정된 위치에서 코드 실행이 일시 중지되며, 이 시점에 변수 값이나 프로그램 상태를 확인할 수 있습니다.
  
  
• 단계별 실행: 중단점에서 코드의 한 줄씩 실행(step over), 함수 안으로 들어가기(step into), 함수에서 나가기(step out) 등의 기능을 통해 코드의 흐름을 자세히 추적할 수 있습니다.
  
  
• 조건부 중단점: 특정 조건이 만족될 때만 중단점을 활성화하여 디버깅하는 방법입니다. 이를 통해 특정 상황에서만 발생하는 버그를 효과적으로 잡아낼 수 있습니다.

1.2 assert를 활용한 간단한 디버깅

Dart에서는 assert 문을 사용하여 코드가 특정 조건을 만족하는지 확인할 수 있습니다.

assert는 개발 중에만 활성화되며, 조건이 false일 경우 예외를 발생시켜 어디에서 문제가 발생했는지 알려줍니다.

void main() {
  int age = -1;
  assert(age >= 0, 'Age cannot be negative');
  print('Age is $age');
}

위 코드에서 age가 음수일 경우, assert가 예외를 발생시키고 프로그램이 중단됩니다. assert는 주로 테스트나 간단한 검증 로직에서 사용됩니다.

1.3 코드 리뷰와 페어 프로그래밍

코드 리뷰는 다른 개발자와 함께 코드를 검토하며 문제점을 찾는 과정입니다. 리뷰를 통해 논리적 오류, 코딩 스타일 문제, 또는 잠재적인 버그를 발견할 수 있습니다. 페어 프로그래밍에서는 두 명의 개발자가 한 컴퓨터로 함께 코딩하며, 한 명이 코드를 작성하고 다른 한 명이 이를 리뷰하는 방식으로 디버깅을 동시에 진행할 수 있습니다.

2. 로그 출력 방법

2.1 print() 함수 사용

가장 기본적인 로그 출력 방법은 print() 함수를 사용하는 것입니다. 코드의 특정 부분에서 변수를 출력하거나, 실행 흐름을 추적하기 위해 print() 문을 삽입할 수 있습니다.

void main() {
  int value = 42;
  print('The value is $value');
}

print() 함수는 콘솔에 메시지를 출력하는 간단한 방법으로, 빠르게 코드를 디버깅할 때 유용합니다.

2.2 debugPrint() 사용

print() 함수는 매우 간단하지만, 출력 메시지가 너무 길 경우 콘솔에 잘리지 않고 출력되도록 보장하는 debugPrint() 함수가 있습니다. 이 함수는 특히 긴 문자열을 출력할 때 유용합니다.

import 'package:flutter/foundation.dart';

void main() {
  String longText = 'This is a very long text...';
  debugPrint(longText);
}

debugPrint()는 기본적으로 출력 메시지의 길이를 제한하며, 긴 메시지를 자동으로 줄 바꿈하여 출력해줍니다.

2.3 로깅 패키지 사용

Dart의 표준 라이브러리에는 강력한 로깅을 위한 logging 패키지가 포함되어 있습니다. 이 패키지는 다양한 로그 레벨을 지원하며, 콘솔뿐만 아니라 파일이나 외부 시스템으로 로그를 쉽게 전송할 수 있습니다.

 

logging 패키지 사용 예제

import 'package:logging/logging.dart';

void main() {
  // Logger 설정
  final Logger logger = Logger('MyAppLogger');

  // 콘솔 핸들러 추가
  logger.onRecord.listen((record) {
    print('${record.level.name}: ${record.time}: ${record.message}');
  });

  // 로그 메시지 출력
  logger.info('This is an info message');
  logger.warning('This is a warning message');
  logger.severe('This is a severe message');
}

logging 패키지를 사용하면 로그 레벨을 세분화하여 info, warning, severe 등의 중요도에 따라 로그를 남길 수 있습니다.

또한, 로그 메시지를 파일로 저장하거나, 원격 서버로 전송할 수 있는 핸들러를 추가하여 확장할 수 있습니다.

3. 디버깅과 로깅의 베스트 프랙티스

• 중단점 적극 활용: 디버깅 시 중단점을 설정하여 코드의 실행 흐름을 자세히 추적하세요. 조건부 중단점은 특정 상황에서만 발생하는 버그를 찾는 데 매우 유용합니다.
  
  
• 적절한 로그 레벨 사용: logging 패키지를 활용하여 로그 메시지를 중요도에 따라 분류하고, 필요한 로그만 출력하도록 설정하세요.
  
  
• 프로덕션 환경에서는 적절한 로그 설정: 개발 환경과 달리, 프로덕션 환경에서는 디버깅 정보가 노출되지 않도록 주의해야 합니다. 중요한 로그만 남기고, 개인 정보나 민감한 데이터가 포함되지 않도록 설정하세요.
  
  
• 코드 리뷰와 협업: 다른 개발자와의 코드 리뷰나 페어 프로그래밍을 통해 문제를 발견하고, 해결 방안을 논의하세요.

 

Dart에서의 디버깅과 로그 출력은 문제를 신속하고 정확하게 해결하는 데 중요한 도구입니다.
print()나 debugPrint() 같은 간단한 방법부터 logging 패키지를 활용한 복잡한 로깅 시스템까지, 다양한 방법을 적절히 활용하여 효율적인 디버깅을 할 수 있습니다.
Dart의 디버깅 기법과 로그 출력을 잘 이해하고 활용하여 더 나은 품질의 코드를 작성해보세요.

구독!! 공감과 댓글은 저에게 큰 힘이 됩니다.

Starting Google Play App Distribution! "Tester Share" for Recruiting 20 Testers for a Closed Test.

Tester Share [테스터쉐어] - Google Play 앱