VS Code로 파이썬 디버깅하기 — print 대신 중단점 쓰기

-

🌐 English

버그를 잡을 때 print(변수)를 넣고 돌리고, 지우고, 다시 다른 데 넣고 돌리기를 반복한 적 있으신가요. 저도 오래 그랬습니다. 그런데 이 방식은 한 번 실행할 때마다 궁금한 것 하나밖에 못 봅니다. 중단점은 그 순간의 모든 것을 한꺼번에 보여줍니다.

기본 — F5와 F9면 시작

중단점(breakpoint)은 "이 줄에 오면 프로그램을 잠시 멈춰라"는 표시입니다. 코드 줄 번호 왼쪽 여백을 클릭하거나 F9를 누르면 빨간 점이 찍힙니다.

F5로 실행하면 그 줄에서 멈추고, 왼쪽 패널에 그 시점의 모든 지역 변수가 펼쳐집니다. 딕셔너리도, 중첩 객체도 전부 열어볼 수 있습니다. print로는 미리 예상한 변수 하나만 보이지만, 중단점은 예상 못 한 변수까지 보여줍니다. 버그는 대개 예상 못 한 쪽에 있죠.

멈춘 뒤 조작은 네 개만 알면 됩니다.

  • F10 스텝 오버 — 다음 줄로. 함수 호출은 통째로 실행하고 넘어감
  • F11 스텝 인 — 함수 안으로 들어감
  • Shift+F11 스텝 아웃 — 현재 함수를 마치고 호출한 곳으로
  • F5 계속 — 다음 중단점까지 쭉 진행

launch.json — 실행 설정 고정

봇은 보통 인자나 환경변수를 받습니다. 매번 손으로 넣지 말고 .vscode/launch.json에 저장합니다.

{

  "version": "0.2.0",

  "configurations": [

    {

      "name": "봇 - 페이퍼 모드",

      "type": "debugpy",

      "request": "launch",

      "program": "${workspaceFolder}/bot.py",

      "args": ["--mode", "paper", "--config", "config.ini"],

      "env": {

        "EXCHANGE_API_KEY": "${env:EXCHANGE_API_KEY}"

      },

      "console": "integratedTerminal",

      "justMyCode": true

    }

  ]

}

justMyCode는 기본값 true일 때 라이브러리 내부로는 들어가지 않습니다. 대개 이게 편하지만, 라이브러리 안에서 나는 에러를 추적할 땐 false로 바꿔야 합니다.

주의: env에 API 키를 직접 적지 마세요. 위처럼 ${env:...}로 참조하거나 envFile을 쓰고, .vscode/도 상황에 따라 .gitignore 대상입니다.

조건부 중단점 — 여기서 판이 바뀐다

이게 진짜 무기입니다. 봇이 1초에 수십 번 도는 루프에서 딱 문제가 나는 그 순간에만 멈추고 싶을 때가 있습니다. 그냥 중단점을 찍으면 수백 번 멈춰서 못 씁니다.

중단점을 우클릭 → 중단점 편집에서 조건을 겁니다.

// 예시 조건식 — 파이썬 표현식을 그대로 쓴다

gap_pct > 3.0                       # 갭이 비정상적으로 클 때만

symbol == "TARGET_SYMBOL"           # 특정 종목일 때만

order is None and retry_count >= 3  # 재시도 3회 후에도 실패했을 때

여기에 적중 횟수(hit count) 조건도 있습니다. >= 500으로 걸면 500번째 통과부터 멈춥니다. "한참 잘 돌다가 어느 순간부터 이상해진다" 같은 버그에 딱 맞습니다.

실전에서 이 기능 하나가 if 조건: import pdb; pdb.set_trace() 같은 임시 코드를 전부 대체합니다. 코드를 건드리지 않으니 지우는 걸 깜빡할 일도 없습니다.

로그포인트 — 멈추지 않는 print

실시간 봇은 멈추면 곤란한 경우가 많습니다. 호가가 계속 들어오는데 5초 멈추면 이미 상황이 달라져 있죠. 이때는 로그포인트(logpoint)를 씁니다.

중단점 우클릭 → 로그 메시지를 고르고 이렇게 적습니다.

진입 판단: {symbol} 갭={gap_pct:.3f} 잔고={balance}

중괄호 안이 실제 값으로 치환되어 디버그 콘솔에 출력됩니다. 프로그램은 멈추지 않습니다. print문의 효과를 내되 코드는 한 글자도 안 바뀝니다. 확인 끝나면 로그포인트만 지우면 되니, 디버그 코드가 커밋에 섞여 들어가는 사고도 없습니다.

조사식과 예외 중단

조사식(Watch) 패널에 표현식을 등록해두면 멈출 때마다 자동으로 재계산됩니다. 단순 변수뿐 아니라 계산식도 됩니다.

len(open_positions)

sum(p.qty * p.price for p in open_positions)

(ask - bid) / bid * 100

디버그 콘솔에서는 멈춘 시점의 컨텍스트로 아무 코드나 실행해볼 수 있습니다. 함수를 직접 호출해서 반환값을 확인하는 것도 가능합니다. 단, 주문 전송 함수처럼 부작용이 있는 코드는 절대 콘솔에서 호출하지 마세요. 실거래 계정이면 진짜로 주문이 나갑니다.

그리고 잘 안 쓰이는데 강력한 기능 하나 — 중단점 패널의 "Raised Exceptions" 체크박스입니다. 켜두면 예외가 발생하는 바로 그 줄에서 멈춥니다. try/except로 삼켜지는 예외까지 잡히기 때문에, "왜 조용히 실패하지?" 유형의 버그에 즉효입니다.

이미 돌고 있는 봇에 붙기

서버에서 며칠째 도는 봇에 이상 징후가 보일 때, 재시작하면 상태가 날아갑니다. 이럴 땐 원격 디버깅으로 붙습니다.

봇 코드에 이 부분을 미리 심어둡니다.

import os

if os.environ.get("DEBUG_ATTACH") == "1":

    import debugpy

    debugpy.listen(("127.0.0.1", 5678))   # 외부 노출 금지

    print("디버거 대기 중... 포트 5678")

    # debugpy.wait_for_client()  # 시작부터 잡고 싶을 때만

그리고 launch.json에 접속 설정을 추가합니다.

{

  "name": "돌고 있는 봇에 붙기",

  "type": "debugpy",

  "request": "attach",

  "connect": { "host": "127.0.0.1", "port": 5678 },

  "pathMappings": [

    { "localRoot": "${workspaceFolder}", "remoteRoot": "/app" }

  ]

}

보안 경고 하나. listen 주소는 반드시 127.0.0.1로 묶으세요. 0.0.0.0으로 열면 인터넷에서 누구나 붙어 봇 프로세스 안에서 임의 코드를 실행할 수 있습니다. 원격 서버라면 SSH 포트 포워딩으로 터널을 뚫어서 접근하는 게 정석입니다.

정리

  • print는 한 번에 하나, 중단점은 그 시점의 전부를 보여준다
  • 실행 인자·환경변수는 launch.json에 고정 (단, 키는 직접 적지 않기)
  • 조건부 중단점 + 적중 횟수가 반복 루프 디버깅의 핵심 무기
  • 멈추면 안 되는 실시간 봇에는 로그포인트 — 코드 수정 없는 print
  • "조용히 실패"하는 버그는 Raised Exceptions 중단으로 잡는다
  • 돌아가는 봇에는 debugpy attach, 단 127.0.0.1에만 바인딩
  • 디버그 콘솔에서 주문 함수 호출 금지 — 실제로 나간다

중단점 사용법을 익히는 데 30분이면 충분합니다. 그 30분 뒤부터 디버깅 속도가 눈에 띄게 달라집니다. print를 지우다 커밋에 섞어 넣는 일도 함께 사라지고요.

댓글

댓글 쓰기

이 블로그의 인기 게시물

한국투자증권 KIS API로 실시간 시세 받기 (WebSocket 실전)

-
🌐 English 주식 자동매매 봇의 심장은 실시간 시세 입니다. REST 폴링만으로는 초 단위 시그널을 만들 수 없습니다. 한국투자증권(KIS) 오픈API는 WebSocket으로 호가와 체결을 밀어주는데, 실전에서 부딪히는 지점들을 자동매매 봇을 만들며 정리한 노트입니다. ⚠️ 이 글은 교육·정보 제공 목적입니다. 투자 권유가 아니며, 투자 손실 책임은 본인에게 있습니다. 두 개의 TR을 구독한다 KIS 실시간에서 자주 쓰는 TR은 두 가지입니다. H0STASP0 — 실시간 호가 (매수·매도 1~10호가) H0STCNT0 — 실시간 체결가 (현재가, 시가, 전일종가, 누적거래량) 시가 기준 전략을 쓴다면 H0STCNT0 이 필수입니다. 체결 메시지 안에 시가(stck_oprc) 가 들어 있어서, 장 시작 첫 체결로 그날의 기준선을 잡을 수 있기 때문입니다. 종목당 두 TR을 구독하므로, 종목이 늘어나면 구독 건수가 빠르게 증가합니다. KIS는 한 연결에 동시 구독 한도(수십 건)가 있으니, 중복 종목은 seen 맵으로 걸러 한 번만 구독합니다. seen := make(map[string]bool) addSym := func(code string) { if code == "" || seen[code] { return // 빈 코드·중복은 skip } seen[code] = true subscribeKIS(conn, approvalKey, "H0STASP0", code) // 호가 time.Sleep(50 * time.Millisecond) subscribeKIS(conn, approvalKey, "H0STCNT0", code) // 체결 time.Sleep(50 * time.Millisecond) } 구독 사이에 짧은 sleep 을 두는 이유는, 여러 구독 프레임을 한...
자세한 내용 보기

파이썬으로 업비트 API 연동하기 — 시세 조회부터 주문까지 기초

-
🌐 English 코인 자동매매를 만들어 보려고 검색하면 대부분 "전략"부터 이야기합니다. 그런데 막상 코드를 짜려고 하면 거래소에 요청을 어떻게 보내는지 에서 먼저 막힙니다. 이 글은 그 첫 관문만 다룹니다. 파이썬으로 업비트 API에 붙어서 시세를 읽고, 잔고를 확인하고, 주문을 넣는 데까지입니다. 0. 준비물 필요한 건 두 가지뿐입니다. 파이썬 패키지 : pip install requests pyjwt — requests는 HTTP 요청 라이브러리, PyJWT는 인증 토큰을 만드는 라이브러리입니다. 업비트 API 키 : 업비트 웹사이트 → 마이페이지 → Open API 관리에서 발급합니다. 발급할 때 허용 IP를 반드시 등록 하고, 처음에는 자산조회·주문조회 권한만 켜세요. 주문 권한은 코드가 검증된 뒤에 켜도 늦지 않습니다. 발급받은 secret key는 발급 화면을 벗어나면 다시 볼 수 없습니다. 그리고 절대 소스코드에 직접 적지 마세요. 환경변수나 설정 파일로 분리합니다. import os ACCESS_KEY = os.environ["UPBIT_ACCESS_KEY"] # 실제 키는 환경변수로 SECRET_KEY = os.environ["UPBIT_SECRET_KEY"] SERVER_URL = "https://api.upbit.com" 1. 시세 조회 — 인증이 필요 없는 요청 가장 쉬운 것부터 합니다. 현재가 조회는 인증 없이 됩니다. 그냥 GET 요청 하나면 끝입니다. import requests def get_price(market="KRW-BTC"): url = f"{SERVER_URL}/v1/ticker" res = requests.get(url, params={"markets": market}, timeout=5) res.rais...
자세한 내용 보기

Go로 자동매매 신호봇 프레임워크 설계하기

-
🌐 English 자동매매 봇을 만들다 보면 전략 코드보다 주변 골격 에 시간을 더 쓰게 됩니다. 설정을 어떻게 읽지? 상태는 어디서 보지? 알림은? 이 글은 실제로 돌아가는 Go 선물 신호봇을 만들며 정리한, 재사용 가능한 프레임워크 뼈대입니다. 핵심 원칙은 하나입니다. 최소 의존성. 설정은 ini 하나, 웹은 표준 net/http , 알림은 텔레그램 REST 호출. 무거운 프레임워크 없이 단일 실행 파일로 끝냅니다. 1. 설정 로더 — config.ini 봇 파라미터는 코드가 아니라 파일에 둡니다. 재빌드 없이 값을 바꾸기 위해서죠. INI는 사람이 편집하기 쉽고 섹션으로 묶기 좋습니다. type AppConfig struct { APIKey, APISecret string Testnet bool LoopIntervalSec int NotionalPerEntry float64 Leverage int DashboardPort int DashboardKey string } func loadConfig(path string) (*AppConfig, error) { f, err := ini.Load(path) if err != nil { return nil, err } c := &AppConfig{} bi := f.Section("binance") c.APIKey = bi.Key("api_key").String() c.Testnet = bi.Key("testnet").MustBool(true) // 기본값을 안전한 쪽으로 tr := f.Section("trading") c.LoopIntervalSec = tr.Key("loop_interval_sec").MustInt(10) c.Leverage = tr.Key("l...
자세한 내용 보기