unity로 게임만들기를 하는동아리원 입니다.

Question

unity로 게임만드는 법을 배우고 게임을 만드는 동아리를 활동하고 있는데 제가 다른 친구들보다 열심히하고 더 잘합니다. 친구가 제코드를 보겠다고 하는데 c언어로 기초만 다져놓은 친구라서 어디까지 주석을 달아줘야될까요?

Answer 1

안녕하세요. 서종현 전문가입니다.

Unity로 게임을 만드는 동아리에서 코드 공유를 하실때, C언어 기초를 가진 친구가 쉽게 이해할수있도록 주석을 충분히 달아주는 것이 좋습니다. 우선 함수나 메서드가 어떤 역할을 하는지 간단히 설명하고, 중요한 변수나 복잡한 로직 조건문에는 왜 그런 처리를 했는지 의도를 함께 적어주세요 특히 unity 특유의 함수(예:update, start)나 게임 오브젝트 관련 부분은 좀더 자세한 설명이 도움이 됩니다. 너무 길게 쓰면 오히려 읽기 어려우니, 간결하면서 핵심을 찌르는 주석이 이상적입니다. 예를들어 이 함수는 플레이어 이동을 처리합니다. 처럼 명확히 목적을 적으면 됩니다. 이렇게 하면 친구가 코드 흐름을 이해하고 자신도 성장하는데 큰 도움이 됩니다.

Answer 2

안녕하세요. 고한석 전문가입니다.

C언어 기초가 있는 친구라면 변수·반복문·조건문 같은 기본 문법 주석은 생략하고, 유니티 특화 개념(MonoBehaviour, Update/Start 생명주기, GetComponent, SerializeField 등)에 집중적으로 주석을 달아주는 게 가장 효율적입니다. 주석 스타일은 "이게 뭔지" 설명보다 "왜 이렇게 짰는지" 의도 위주로 달아주면 훨씬 도움이 되는데, 예를 들어 // 충돌 감지용 보다 // 플레이어가 적과 닿았을 때만 데미지 처리 — OnTrigger 쓴 이유 처럼 쓰면 코드 읽는 실력이 빠르게 늡니다. 처음부터 완벽한 주석보다 친구가 모르는 부분을 직접 물어보게 유도하는 방식이 서로에게 더 좋은데, 질문하면서 배우는 게 주석 읽는 것보다 훨씬 빨리 실력이 늘거든요! 🎮💻

Answer 3

안녕하세요. 감병주 전문가입니다.

친구가 C언어 기초만 아는 수준이라면 코드 한 줄마다 주석을 달 필요는 없습니다.
코드가 무엇을 하는지보다 왜 그렇게 만들었는지를 설명하는 주석이 더 도움이 되고 스크립트 상단에는 전체 기능을, 함수 위에는 역할을 간단히 적어주는 것이 좋습니다. 또 복잡한 계산이나 로직이 있는 부분만 추가 설명을 달아주면 충분합니다.
Update(), Start(), Rigidbody, Animator 같은 Unity 핵심 기능은 별도로 설명해 주는 것이 좋습니다. 좋은 주석은 코드 해석보다 동작 원리와 설계 의도를 이해하도록 돕는 주석입니다.