Split View: IDE별 디버깅 완전정리: VS Code · IntelliJ IDEA · PyCharm 브레이크포인트, 실행 구성, 프로파일링

{
  "version": "0.2.0",
  "configurations": [
    {
      // Python FastAPI 디버깅
      "name": "Python: FastAPI",
      "type": "debugpy",
      "request": "launch",
      "module": "uvicorn",
      "args": ["app.main:app", "--reload", "--port", "8000"],
      "console": "integratedTerminal",
      "envFile": "${workspaceFolder}/.env",
      "justMyCode": true // 라이브러리 코드 스킵 (false로 바꾸면 진입 가능)
    },
    {
      // Node.js Express/NestJS 디버깅
      "name": "Node: API Server",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/dist/index.js",
      "preLaunchTask": "npm: build", // 빌드 후 실행
      "runtimeArgs": ["--inspect-brk"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "envFile": "${workspaceFolder}/.env",
      "console": "integratedTerminal"
    },
    {
      // Node.js 실행 중인 프로세스에 연결
      "name": "Attach to Node",
      "type": "node",
      "request": "attach",
      "port": 9229,
      "restart": true, // 프로세스 재시작 시 자동 재연결
      "sourceMaps": true
    },
    {
      // Go Delve 디버깅
      "name": "Go: Launch API",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}/cmd/api",
      "env": {
        "GO_ENV": "development"
      },
      "args": ["-config", "config.dev.yaml"]
    },
    {
      // Next.js 서버 사이드 디버깅
      "name": "Next.js: Server",
      "type": "node",
      "request": "launch",
      "runtimeExecutable": "npx",
      "runtimeArgs": ["next", "dev"],
      "sourceMaps": true,
      "cwd": "${workspaceFolder}",
      "console": "integratedTerminal"
    },
    {
      // pytest 디버깅 (특정 테스트)
      "name": "Python: pytest Current File",
      "type": "debugpy",
      "request": "launch",
      "module": "pytest",
      "args": ["${file}", "-v", "--no-header"],
      "console": "integratedTerminal",
      "justMyCode": false // 테스트 시 라이브러리 내부도 확인
    }
  ],
  "compounds": [
    {
      // 프론트+백엔드 동시 디버깅
      "name": "Full Stack",
      "configurations": ["Python: FastAPI", "Next.js: Server"]
    }
  ]
}

조건부 브레이크포인트 설정 방법:
1. 라인 번호 좌측 클릭으로 브레이크포인트 설정
2. 브레이크포인트 우클릭 → "Edit Breakpoint..."
3. 조건 유형 선택:
   - Expression: user.id === "U-9999" (조건이 true일 때만 중단)
   - Hit Count: 100 (100번째 호출에서 중단)
   - Log Message: "userId={user.id} total={total}" (중단 없이 로그만)

Exception Breakpoint 설정 방법:
1. Run → Add Configuration → 또는 Debug 패널 → BREAKPOINTS 섹션
2. "Add Function Breakpoint" 또는 언어별 Exception BP 추가
   - Python: "Raised Exceptions" / "Uncaught Exceptions" 체크
   - Node.js: "All Exceptions" / "Uncaught Exceptions" 체크

// tasks.json — 디버그 전에 실행할 빌드 태스크
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Start Docker DB",
      "type": "shell",
      "command": "docker compose up -d postgres redis",
      "problemMatcher": []
    }
  ]
}

필수 표준화 항목:
1. JVM 옵션: -Xmx512m -XX:+HeapDumpOnOutOfMemoryError
2. 환경변수 파일: .env 또는 EnvFile 플러그인 연결
3. 활성 프로파일: -Dspring.profiles.active=dev
4. Working directory: $MODULE_DIR$ (모듈 루트 고정)
5. Before launch: Build 태스크 자동 실행 확인

<!-- .run/SpringBootApp.run.xml — Git에 포함하여 팀 공유 -->
<component name="ProjectRunConfigurationManager">
  <configuration name="Spring Boot API" type="SpringBootApplicationConfigurationType">
    <module name="api" />
    <option name="SPRING_BOOT_MAIN_CLASS" value="com.example.ApiApplication" />
    <option name="ACTIVE_PROFILES" value="dev" />
    <envs>
      <env name="DB_HOST" value="localhost" />
      <env name="DB_PORT" value="5432" />
    </envs>
    <option name="VM_PARAMETERS"
            value="-Xmx512m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/tmp/" />
  </configuration>
</component>

Remote Debug Configuration 설정:
1. Run → Edit Configurations → + → Remote JVM Debug
2. Host: localhost, Port: 5005
3. Command line arguments 복사하여 서버 실행 시 적용
4. "Auto restart" 체크하면 서버 재시작 시 자동 재연결

IntelliJ 브레이크포인트 고급 옵션 (우클릭 → More):

1. Condition: orderId.equals("ORD-1234")
   → 조건이 true일 때만 중단

2. Log message to console: "Processing order: " + orderId
   → 중단 없이 디버그 콘솔에 출력 (Logpoint)

3. Evaluate and log: order.getItems().size()
   → 표현식을 평가하고 결과를 로그로 출력

4. Remove once hit: 한 번 걸리면 자동 제거
   → 초기화 코드처럼 한 번만 확인할 때 유용

5. Disable until hitting another breakpoint
   → 특정 조건에 도달한 후부터 활성화 (체이닝)

6. Instance filter: 특정 객체 인스턴스에서만 중단
   → 멀티스레드 환경에서 특정 요청만 추적

Exception Breakpoint 설정:
1. Run → View Breakpoints (Cmd+Shift+F8 / Ctrl+Shift+F8)
2. + → Java Exception Breakpoints
3. NullPointerException, IllegalStateException 등 선택
4. "Caught exception" / "Uncaught exception" 체크
5. Class filters로 내 패키지만 필터링: com.example.*

멀티스레드 디버깅 설정:
1. 브레이크포인트 우클릭 → Suspend policy 설정
   - All: 모든 스레드 중단 (기본값)
   - Thread: 해당 스레드만 중단, 나머지는 계속 실행

2. Threads 패널에서:
   - 각 스레드의 스택 트레이스 확인
   - 스레드 간 전환하여 변수 상태 비교
   - "Resume thread" 로 특정 스레드만 재개

3. 데드락 감지:
   - Debug 패널 → 우클릭 → "Detect Deadlock"
   - 자동으로 데드락 관련 스레드와 Lock 정보 표시

IntelliJ 내장 프로파일러 (Ultimate):
1. Run → Profile (CPU/Memory 선택)
2. 또는 실행 아이콘 옆 드롭다운 → "Profile with IntelliJ Profiler"
3. 결과:
   - Flame Graph: 핫스팟 시각화
   - Call Tree: 호출 관계별 시간 분포
   - Method List: 함수별 총 시간/자체 시간
   - Timeline: 시간축 기반 스레드별 활동

JFR 파일 분석:
1. .jfr 파일을 IntelliJ에서 직접 열기
2. Flame Graph / Call Tree로 상위 10개 함수부터 분석
3. Allocation 탭에서 메모리 할당 핫스팟 확인

PyCharm Run Configuration 표준화:

1. Django 서버:
   - Type: Django Server
   - Host: 0.0.0.0, Port: 8000
   - Environment variables: .env 파일 연결
   - Additional options: --settings=config.settings.dev

2. FastAPI (uvicorn):
   - Type: Python
   - Module name: uvicorn
   - Parameters: app.main:app --reload --port 8000
   - Working directory: $PROJECT_DIR$
   - EnvFile 플러그인으로 .env 로드

3. pytest (단위 테스트):
   - Type: pytest
   - Target: tests/unit/
   - Additional arguments: -v --tb=short
   - Environment variables: TESTING=true

4. pytest (통합 테스트):
   - Type: pytest
   - Target: tests/integration/
   - Additional arguments: -v --tb=long -x
   - Environment variables: DB_HOST=localhost

# conftest.py에서 테스트용 디버그 설정
import pytest

@pytest.fixture(autouse=True)
def debug_sql_queries(settings):
    """테스트 중 SQL 쿼리 로그 출력"""
    settings.DEBUG = True
    settings.LOGGING = {
        'version': 1,
        'handlers': {'console': {'class': 'logging.StreamHandler'}},
        'loggers': {
            'django.db.backends': {
                'level': 'DEBUG',
                'handlers': ['console'],
            }
        }
    }

PyCharm 브레이크포인트 옵션:

1. Condition + Hit Count 조합:
   - Condition: len(items) > 100
   - 활성화 조건: Hit count >= 5
   → 아이템이 100개 초과인 요청이 5번째 이상일 때만 중단

2. Django/FastAPI 엔드포인트 진입점에 우선 배치:
   - View 함수 첫 줄
   - serializer.is_valid() 직후
   - ORM 쿼리 실행 직전

3. Evaluate and Log:
   - 브레이크포인트 우클릭 → "Evaluate and log"
   - 예시: f"user={request.user}, method={request.method}"
   - 중단 없이 디버그 콘솔에 출력

# 조건부 브레이크포인트 실전 예시
def process_batch(items):
    for i, item in enumerate(items):
        # PyCharm에서 이 라인에 조건부 BP 설정:
        # Condition: item.status == "ERROR" and i > 50
        # → 50번째 이후의 ERROR 아이템에서만 중단
        result = transform(item)
        save(result)

PyCharm 멀티스레드 디버깅:

1. Thread 패널에서 활성 스레드 목록 확인
2. 스레드 선택하여 개별 스택 트레이스 확인
3. 브레이크포인트의 Suspend policy:
   - All Threads: 모든 스레드 중단
   - Thread: 해당 스레드만 중단

Django + Celery 동시 디버깅:
1. Compound Run Configuration 생성
2. 구성 1: Django Server (runserver)
3. 구성 2: Python → celery -A config worker -l debug
4. 양쪽에 독립적 브레이크포인트 설정 가능

# gunicorn 멀티워커 디버깅 — 단일 워커로 제한
# gunicorn.conf.py
workers = 1          # 디버깅 시 워커 1개로 제한
timeout = 300        # 브레이크포인트에서 멈춰도 타임아웃 안 되게
accesslog = '-'      # stdout으로 로그 출력

PyCharm 내장 프로파일러 (Professional):
1. Run → Profile 'configuration name'
2. 또는 실행 아이콘 옆 → "Profile"
3. 결과 분석:
   - Call Graph: 함수 호출 관계와 시간 시각화
   - Statistics: 함수별 호출 횟수/총 시간/자체 시간 테이블
   - 느린 함수 클릭 → 소스코드로 바로 이동

Line Profiler 연동:
1. pip install line-profiler
2. @profile 데코레이터를 느린 함수에 적용
3. kernprof -l -v script.py 실행
4. 결과: 함수 내 각 라인별 실행 시간/호출 횟수

cProfile 통합:
1. Run → Profile → cProfile 선택
2. 결과를 .prof 파일로 저장
3. snakeviz로 시각화: snakeviz output.prof

# memory_profiler로 메모리 사용량 라인별 분석
from memory_profiler import profile

@profile
def load_dataset():
    data = []                        # 시작: 50 MiB
    for chunk in read_chunks():
        processed = transform(chunk) # 여기서 +200 MiB → 누수 의심
        data.append(processed)
    return data                      # 최종: 800 MiB

# .gitignore 예시
# IntelliJ — 개인 설정 제외, 공통 실행 구성은 포함
.idea/*
!.idea/runConfigurations/
!.idea/codeStyles/

# VS Code — launch.json은 포함
.vscode/*
!.vscode/launch.json
!.vscode/tasks.json
!.vscode/extensions.json

# Makefile 예시
.PHONY: debug test profile

debug-api:
	docker compose up -d postgres redis
	python -m debugpy --listen 5678 --wait-for-client -m uvicorn app.main:app --reload

debug-test:
	pytest -x --pdb -v tests/

profile-api:
	py-spy record -o profile.svg --pid $$(pgrep -f uvicorn)