Skip to content

배움의 길

평생 배워야하는 것은 우리들의 운명이다.

Menu
Menu

리액트(React) 컴포넌트와 JSX 기본 개념 완벽 정리: 초보자가 꼭 알아야 할 필수 문법 가이드

Posted on 2026년 11월 03일2026년 11월 01일 by steve

 

리액트(React) 입문할 때 만나는 컴포넌트와 JSX, 왜 이렇게 생겼는지 막막하셨나요? 웹 화면을 레고 블록처럼 조립하는 컴포넌트의 핵심 원리부터 초보자가 실수하기 쉬운 JSX 필수 문법 규칙까지 눈높이에 맞춰 쉽고 명확하게 정리해 드립니다!

 

제가 처음 HTML과 CSS, 그리고 기초적인 자바스크립트를 겨우 익히고 나서 리액트(React)를 처음 켰을 때의 충격을 아직도 잊지 못해요. 솔직히 말해서 처음엔 코드가 고장 난 줄 알았거든요. 분명히 자바스크립트 파일인데 그 안에 <div>나 <h1> 같은 HTML 태그가 따옴표도 없이 그대로 들어있으니까요! “아니, 지금까지는 HTML이랑 자바스크립트를 철저히 분리하라고 배웠는데 왜 다시 합쳐놓은 거지?” 싶어서 머리가 지끈거렸던 기억이 납니다. 😅

하지만 걱정하지 마세요. 처음에는 낯설어 보여도 컴포넌트(Component)와 JSX라는 두 가지 개념만 제대로 이해하면, 리액트만큼 직관적이고 재밌는 도구가 없답니다. 오늘 이 글을 끝까지 읽으시면 왜 전 세계 수많은 개발자가 리액트에 열광하는지, 그리고 어떻게 코드를 작성해야 에러 없이 깔끔한 화면을 만들 수 있는지 완벽하게 감을 잡으실 수 있을 거예요! 😊

 

리액트 컴포넌트(Component), 대체 정체가 뭘까요? 🤔

리액트를 한 문장으로 요약하라면 저는 주저 없이 “화면을 레고 블록처럼 조립해서 만드는 도구”라고 말해요. 여기서 말하는 레고 블록 하나하나가 바로 컴포넌트(Component)입니다. 기존 웹 개발 방식에서는 웹 페이지 전체를 하나의 거대한 HTML 파일로 작성하곤 했어요. 그러다 보니 코드가 수천 줄로 길어지면 어디서 무엇을 고쳐야 할지 찾기가 정말 힘들었죠.

반면 리액트는 화면을 독립적인 부품 단위로 쪼개서 생각합니다. 예를 들어 쇼핑몰 사이트를 만든다고 해볼게요. 상단 메뉴바(Header), 검색창(SearchBar), 상품 카드(ProductCard), 하단 정보(Footer)를 각각 별도의 컴포넌트로 만듭니다. 그리고 필요할 때마다 이 블록들을 가져와서 착착 조립하기만 하면 전체 페이지가 완성되는 거예요. 진짜 효율적이지 않나요?

과거에는 클래스(Class) 방식으로 컴포넌트를 만들기도 했지만, 2019년 리액트 16.8 버전에서 훅(Hooks)이 도입된 이후부터 현재(2026년 기준 리액트 공식 문서 권장 사항)까지는 함수형 컴포넌트(Functional Component)가 완전한 표준으로 자리 잡았습니다. 그냥 일반 자바스크립트 함수를 만들고, 그 함수가 화면에 보여줄 UI를 반환(return)하게 작성하면 그게 바로 컴포넌트가 됩니다.

💡 알아두세요!
리액트 컴포넌트의 이름을 지을 때는 반드시 첫 글자를 영어 대문자(PascalCase)로 시작해야 합니다. 예를 들어 myButton이 아니라 MyButton이라고 적어야 해요. 첫 글자가 소문자이면 리액트는 이를 사용자가 만든 컴포넌트가 아니라 일반 HTML 태그(<div>, <span> 등)로 오해해서 화면에 제대로 그리지 못한답니다!

 

자바스크립트 품에 안긴 HTML, JSX란 무엇인가요? 📊

자, 그럼 이제 컴포넌트를 만들 때 함수 안에서 반환하는 그 신기한 HTML 모양의 코드를 살펴볼 차례예요. 이 친구의 정식 명칭은 JSX(JavaScript XML)입니다. 이름 그대로 자바스크립트를 확장해서 HTML과 아주 비슷하게 코드를 작성할 수 있도록 만든 문법이에요.

여기서 정말 중요한 사실 하나! 사실 웹 브라우저는 JSX를 직접 읽지 못해요. 우리가 보기 편하게 JSX로 코드를 작성하면, 프로젝트 내부의 바벨(Babel)이나 최신 빌드 도구가 이를 브라우저가 이해할 수 있는 순수 자바스크립트 코드(React.createElement 형태)로 실시간 번역을 해주는 거랍니다. 개발자의 가독성과 생산성을 극대화하기 위해 만든 똑똑한 문법 설탕(Syntactic Sugar)인 셈이죠.

하지만 JSX는 완벽한 HTML이 아니라 결국 ‘자바스크립트’로 변환되는 코드이기 때문에, 기존 HTML과는 미묘하게 다른 규칙들을 가지고 있어요. 처음 입문할 때 가장 많이 헷갈리는 차이점을 아래 표로 한눈에 정리해 봤습니다.

일반 HTML vs 리액트 JSX 핵심 문법 비교

구분 일반 HTML 리액트 JSX 변경 이유 및 핵심 특징
CSS 클래스 지정 class="box" className="box" 자바스크립트 예약어인 class와의 충돌 방지
라벨 연결 속성 for="userId" htmlFor="userId" 자바스크립트 반복문 예약어 for와의 충돌 방지
태그 닫기 규칙 <input>, <br> <input />, <br /> 홀로 쓰이는 태그도 반드시 슬래시(/)로 닫아야 함
인라인 스타일 style="font-size: 16px;" style={{ fontSize: '16px' }} 문자열이 아닌 카멜케이스(camelCase) 객체 형태로 전달
이벤트 핸들러 onclick="fn()" onClick={fn} 카멜케이스로 표기하며 함수 자체를 중괄호로 전달
⚠️ 주의하세요!
JSX를 작성할 때 초보자가 99% 겪는 에러 1위는 바로 “단 하나의 부모 태그(Root Element)로 감싸야 한다”는 규칙을 어기는 것입니다. 컴포넌트가 반환하는 최상위 태그는 무조건 하나여야 해요! 만약 불필요한 <div> 태그를 추가하기 싫다면, 이름 없는 빈 태그인 프래그먼트(Fragment, <> ... </>)로 감싸주면 실제 HTML 구조를 어지럽히지 않고 깔끔하게 묶을 수 있답니다.

 

컴포넌트 재사용의 마법과 효율성 계산법 🧮

그렇다면 왜 굳이 이런 문법 규칙을 익혀가면서까지 컴포넌트를 만들어야 할까요? 가장 큰 이유는 바로 압도적인 재사용성과 유지보수 효율 때문이에요. 똑같은 디자인의 버튼이나 카드를 페이지마다 복사해서 붙여넣기 했다가, 나중에 디자이너가 “모서리를 조금 더 둥글게 바꿔주세요!”라고 요청했을 때 50개의 파일을 일일이 찾아다니며 수정했던 아찔한 경험, 다들 한 번쯤 있으시죠?

컴포넌트를 사용하면 원본 컴포넌트 파일 딱 하나만 수정하면 됩니다. 그러면 그 컴포넌트를 가져다 쓴 50곳의 화면이 1초 만에 동시에 바뀌거든요! 실제로 컴포넌트를 도입했을 때 얼마나 많은 개발 시간을 아낄 수 있는지 간단한 공식으로 확인해 볼까요?

📝 컴포넌트 재사용 시간 절약 공식

총 절약 시간(분) = (개별 UI 작성 및 수정 시간 × 반복 사용 횟수) – (초기 컴포넌트 제작 시간 + 반복 호출 시간)

예를 들어 상품 카드 UI 하나를 만들고 나중에 수정하는 데 평균 20분이 걸리고, 프로젝트에서 이를 15번 사용한다고 가정해 볼게요.

1) 첫 번째 단계 (일반 복사/붙여넣기 방식): 20분 × 15회 = 총 300분 소요

2) 두 번째 단계 (리액트 컴포넌트 방식): 초기 제작 25분 + (호출 1분 × 15회) = 총 40분 소요

→ 최종 결론: 무려 260분(4시간 20분)의 코딩 및 유지보수 시간을 절약할 수 있습니다!

🔢 리액트 컴포넌트 재사용 효율 계산기

UI 블록 복잡도:

반복 사용 횟수:

예상 절약 개발·유지보수 시간:

중복 코드 감소 효과:

 

중괄호 {}의 마법과 실무 JSX 작성 노하우 👩‍💻👨‍💻

JSX를 진짜 제대로 활용하려면 중괄호({})와 친해져야 합니다. HTML 태그 사이에 동적인 자바스크립트 변수나 계산식을 넣고 싶을 때는 언제든 중괄호만 열면 되거든요! 예를 들어 const userName = "민수";라는 변수가 있다면, JSX 안에서 <h1>안녕하세요, {userName}님!</h1>이라고 적기만 하면 화면에 "안녕하세요, 민수님!"이라고 멋지게 출력됩니다.

여기서 꼭 알아두셔야 할 핵심 포인트는 중괄호 안에는 '값으로 평가되는 표현식(Expression)'만 들어갈 수 있다는 점이에요. 숫자 계산({10 + 20}), 변수 이름, 함수 호출 결과, 또는 삼항 연산자({isLogin ? '환영합니다' : '로그인하세요'})는 모두 가능하지만, 일반 if 조건문이나 for 반복문을 중괄호 안에 그대로 쓰면 문법 에러가 발생합니다. 저도 처음엔 습관처럼 중괄호 안에 if문을 넣었다가 빨간 에러 화면을 보고 당황했던 적이 한두 번이 아니에요.

📌 알아두세요!
JSX 안에서 주석(Comment)을 달 때도 중괄호를 활용해야 합니다. 일반 HTML 주석인 <!-- 주석 -->을 쓰면 에러가 나거나 화면에 글자가 그대로 노출될 수 있어요. JSX 내부에서는 반드시 {/* 여기에 주석을 작성하세요 */} 형태로 작성해야 안전하게 주석 처리가 됩니다! (대부분의 에디터에서 Ctrl + / 또는 Cmd + / 단축키를 누르면 자동으로 이 형태로 만들어 줍니다.)

 

실전 예시: 나만의 프로필 카드 컴포넌트 만들기 📚

이론만 보면 아직 손에 잘 안 잡힐 수 있으니, 실제 상황에서 일반 HTML 코드를 어떻게 리액트 컴포넌트와 JSX로 바꾸는지 구체적인 사례를 통해 단계별로 살펴볼게요.

사례 주인공의 상황

  • 주인공: 사내 팀원 소개 페이지를 맡게 된 신입 프론트엔드 개발자 지훈 씨
  • 문제 상황: 팀원 20명의 이름, 직무, 한 줄 소개가 담긴 카드 UI를 만들어야 하는데, HTML을 20번 복사해 두었더니 수정 요청이 올 때마다 야근이 반복됨

컴포넌트 및 JSX 변환 과정

1) 첫 번째 단계 (함수 선언): 대문자로 시작하는 function ProfileCard(props) 함수를 만듭니다.

2) 두 번째 단계 (JSX 문법 적용): 기존 HTML의 class="card"를 className="card"로 수정하고, 이미지 태그를 <img src={props.imgUrl} alt={props.name} />처럼 끝부분을 꼭 닫아줍니다.

3) 세 번째 단계 (동적 데이터 연결): 고정된 이름 대신 <h3>{props.name}</h3>, <p>{props.role}</p>처럼 중괄호를 사용해 외부에서 전달받은 값(Props)이 들어가도록 자리를 비워둡니다.

최종 결과

- 코드 분량 혁신: 약 300줄에 달하던 중복 HTML 코드가 <ProfileCard name="김지훈" role="프론트엔드" /> 형태의 깔끔한 한 줄 호출로 변경되어 전체 코드량 75% 감소!

- 유지보수 시간 단축: 카드 테두리 색상 변경 요청 시 ProfileCard 컴포넌트 한 곳만 수정하여 30초 만에 작업 완료!

지훈 씨의 사례처럼 처음 컴포넌트를 분리할 때는 몇 분 정도 고민할 시간이 필요하지만, 한 번 구조를 잡아두면 프로젝트가 커질수록 개발 속도가 눈에 띄게 빨라진답니다. 처음엔 작은 버튼이나 제목 영역부터 하나씩 컴포넌트로 분리해 보는 연습을 해보세요.

 

마무리: 핵심 내용 요약 📝

오늘 함께 알아본 리액트 컴포넌트와 JSX의 핵심 개념, 이제 머릿속에 그림이 좀 그려지시나요? 헷갈리지 않도록 가장 중요한 4가지 원칙을 다시 한번 정리해 드릴게요.

  1. 독립된 UI 블록, 컴포넌트: 화면을 재사용 가능한 부품 단위로 쪼갠 것이며, 함수 이름은 반드시 대문자(PascalCase)로 시작합니다.
  2. 직관적인 UI 작성법, JSX: 자바스크립트 안에서 HTML 구조를 쉽게 작성하도록 돕는 문법이며, 최상위 부모 태그는 반드시 하나(또는 <></>)여야 합니다.
  3. HTML과 다른 속성 규칙: class 대신 className을 쓰고, <input />처럼 모든 태그는 스스로 닫혀야 합니다.
  4. 중괄호 {}의 활용: 자바스크립트 변수나 삼항 연산자 같은 표현식을 화면에 출력할 때는 중괄호로 감싸줍니다.

처음 리액트를 배울 때는 낯선 문법 때문에 에러 메시지를 자주 만나게 되지만, 사실 리액트의 에러 메시지는 어디가 틀렸는지 아주 친절하게 알려주는 편이에요. 오늘 배운 규칙들을 하나씩 적용하며 직접 간단한 컴포넌트부터 만들어 보시면 금방 손에 익으실 겁니다!

💡

리액트 컴포넌트 & JSX 한눈에 보기

✨ 컴포넌트 정의: 첫 글자는 무조건 대문자! UI를 독립적이고 재사용 가능한 함수 블록으로 분리합니다.
📊 JSX 필수 문법: 단 하나의 부모 태그(<></>) 반환! 속성은 className, 모든 태그는 닫기(/>) 필수입니다.
🧮 컴포넌트 공식:

컴포넌트 함수(입력값 Props) = 화면에 그려질 JSX UI 반환

👩‍💻 동적 데이터 연결: 중괄호 { } 안에 표현식 작성! 변수, 연산, 삼항 연산자를 자유롭게 결합하세요.

기초 문법만 지켜도 리액트 초기 에러의 90% 이상을 예방할 수 있습니다!

자주 묻는 질문 ❓

Q: 리액트를 할 때 무조건 JSX 문법을 사용해야 하나요?
A: 의무 사항은 아닙니다! React.createElement() 함수를 직접 호출해서 작성할 수도 있어요. 하지만 코드가 조금만 복잡해져도 중첩 구조 파악이 매우 힘들어지기 때문에, 실무에서는 가독성과 유지보수를 위해 사실상 100% JSX를 사용하고 있습니다.

Q: 컴포넌트 파일 확장자는 .js와 .jsx 중 무엇으로 해야 하나요?
A: 둘 다 작동하지만, 최근 실무와 Vite 등 최신 빌드 도구 환경에서는 JSX 문법이 포함된 컴포넌트 파일은 명시적으로 .jsx(타입스크립트 사용 시 .tsx) 확장자를 사용하는 것을 강력히 권장합니다. 코드 에디터의 자동 완성 기능과 파일 구분 측면에서 훨씬 유리하거든요.

Q: JSX의 return 문 뒤에 소괄호 ()는 왜 붙이는 건가요?
A: 자바스크립트의 자동 세미콜론 삽입(ASI) 규칙 때문입니다. return 키워드 바로 다음 줄에 개행해서 태그를 적으면, 자바스크립트가 return;으로 문장이 끝났다고 오해해 아무것도 반환하지 않는 버그가 생길 수 있어요. 여러 줄의 JSX를 반환할 때는 항상 return ( ... );처럼 소괄호로 감싸주는 것이 안전합니다.

Q: 하나의 파일 안에 여러 개의 컴포넌트를 만들어도 되나요?
A: 네, 가능합니다! 규모가 아주 작고 해당 파일 내부에서만 보조적으로 쓰이는 컴포넌트라면 한 파일에 같이 작성해도 괜찮습니다. 다만 다른 페이지에서도 재사용할 컴포넌트라면, 관리하기 쉽도록 파일 하나당 하나의 주요 컴포넌트만 작성해 분리하는 것이 좋습니다.

Q: 클래스형 컴포넌트도 지금 따로 공부해야 할까요?
A: 리액트를 처음 배우는 단계라면 함수형 컴포넌트와 Hooks(useState, useEffect 등)만 공부하셔도 충분합니다! 아주 오래된 레거시 프로젝트를 유지보수해야 하는 특수한 상황이 아니라면 현재 모든 신규 프로젝트는 함수형 컴포넌트로 개발됩니다.

오늘 정리해 드린 리액트 컴포넌트와 JSX 기초 가이드가 여러분의 프론트엔드 첫걸음에 든든한 도움이 되었기를 바랍니다! 직접 코드를 따라 쳐보시면서 막히는 부분이나 더 궁금한 점이 있다면 언제든 댓글로 물어봐주세요~ 😊

최신 글

  • 유료 강의 결제 전 필독! 유튜브 프리미엄급 무료 개발·디자인 채널 추천 모음
  • 비전공자가 생활코딩 유튜브로 프로그래밍 입문한 후기 및 현실 공부 순서
  • 코세라(Coursera) 해외 명문대 온라인 강의 수료 후기: 무료 청강부터 수료증 발급까지
  • 유데미(Udemy) 할인 기간 완벽 정리: 글로벌 IT 강의 80% 이상 싸게 사는 법
  • 클래스101 구독형 서비스(CLASS101+) 요금제 비교와 본전 뽑는 활용법

보관함

  • 2026년 11월
  • 2026년 10월

카테고리

  • 교육

소개 및 문의 · 개인정보처리방침 · 면책조항

©2026 배움의 길 | Design: Newspaperly WordPress Theme