블록체인 학습
0 XP

주석과 코드 구조

코드를 잘 쓰려면 먼저 잘 읽을 줄 알아야 합니다. 새 코드를 만나면 한 줄씩 천천히 '이 줄이 무엇을 하는가'를 입으로 말해보는 습관이 큰 도움이 됩니다. 아래 컨트랙트를 그렇게 읽어보세요.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
 
contract Counter {
    uint256 public count; // 현재 카운트 (저장되는 값)
 
    // count 를 1 증가시키는 기능
    function increment() public {
        count += 1;
    }
}

한 줄씩 해석하기

  • // 뒤는 주석(comment)입니다. 실행되지 않고, 사람이 읽도록 설명을 적는 곳입니다.
  • uint256 public count;는 정수 상태 변수입니다. 초기값을 안 적으면 자동으로 0이 됩니다.
  • function increment() public { ... }는 함수(function)로, 컨트랙트가 할 수 있는 '동작'입니다.
  • count += 1;은 저장된 값을 1 늘립니다. 이렇게 상태를 바꾸는 동작은 트랜잭션으로 실행되고 gas가 듭니다.

읽기 습관 들이기

낯선 컨트랙트는 보통 위에서 아래로 읽으면 빠릅니다. 머리말(SPDX/pragma) → 컨트랙트 이름 → 상태 변수(무엇을 저장하는가) → 함수(무엇을 할 수 있는가) 순서입니다. 이렇게 보면 컨트랙트의 '데이터'와 '동작'이 한눈에 들어옵니다.

오른쪽에서 Run 해보고, 주석을 바꾸거나 추가해 보세요. 주석은 결과에 영향을 주지 않습니다.

좋은 주석은 '무엇을'이 아니라 '왜'를 설명합니다. 코드만 봐도 아는 내용보다, 의도를 남겨두면 나중의 나와 동료에게 도움이 됩니다.

여기서 처음 나온 함수는 다음 차시에서 본격적으로 다룹니다. 지금은 "컨트랙트가 할 수 있는 동작을 묶어 둔 것"이라는 큰 그림만 잡으면 충분합니다.

Code Editor
에디터를 불러오는 중...
실행 결과

Run 버튼을 눌러 코드를 실행하세요.