React 프로젝트에서 Bootstrap 사용 방법 (초보자 가이드)

발행: (2025년 12월 25일 오전 01:03 GMT+9)
6 min read
원문: Dev.to

Source: Dev.to

Ahmad Mahboob

소개

이 블로그에서는 Bootstrap이 무엇인지, React 프로젝트에서 Bootstrap을 어떻게 사용하는지, 그리고 왜 Bootstrap을 사용하는지에 대해 논의합니다. 먼저, Bootstrap이 무엇인지 이해해 봅시다:

Bootstrap은 강력하고 기능이 풍부한 프론트엔드 툴킷입니다. 프로토타입부터 프로덕션까지, 몇 분 안에 무엇이든 구축할 수 있습니다. — Bootstrap 공식 웹사이트

왜 React와 Bootstrap을 사용하나요?

Bootstrap은 미리 만들어진 컴포넌트를 제공하고 유틸리티 클래스로 커스터마이징할 수 있어 개발자가 UI 컴포넌트를 더 빠르게 구축하도록 도와줍니다. 특히 React를 배우는 초보자에게는 CSS를 처음부터 작성하는 대신 React 개념에 집중할 수 있게 해줍니다.

Note: Bootstrap은 고도로 맞춤화된 UI가 필요한 프로젝트에는 이상적이지 않지만, 학습 및 빠른 프로토타이핑에 훌륭한 리소스입니다.

전제 조건

이 초보자 가이드를 따라하려면 다음이 필요합니다:

  • 기본 React 지식.
  • 시스템에 설치된 Node.js.
  • React 프로젝트 (Vite로 생성할 수 있습니다):
npm create vite@latest project-name

Source:

React에 Bootstrap 설치

1️⃣ npm으로 설치

터미널에서 다음 명령어 중 하나를 실행하세요:

npm install bootstrap@5.3.8
# 또는 짧은 플래그 사용
npm i bootstrap@5.3.8

이 명령은 Bootstrap 5.3.8(또는 최신 버전)을 프로젝트에 설치합니다. 아래 스크린샷과 비슷한 출력이 표시됩니다:

Bootstrap 다운로드 중

package.json에서 설치가 반영됐는지 확인할 수 있습니다:

package.json 확인

Note: 정확한 버전은 다를 수 있습니다. 최신 릴리스는 공식 Bootstrap 웹사이트에서 확인하세요.

2️⃣ Bootstrap CSS 가져오기

main.jsx(또는 index.js)에 다음 import 문을 추가합니다:

import 'bootstrap/dist/css/bootstrap.min.css';

Note: React와 함께 Bootstrap을 사용할 때 jQuery는 필요하지 않습니다.

React 컴포넌트에서 Bootstrap 클래스 사용하기

이제 JSX에서 Bootstrap 클래스를 직접 적용할 수 있습니다. 예시:

function App() {
  return (
    <>
      <div className="container">
        Hello World! - Styled using Bootstrap
      </div>
    </>
  );
}

export default App;

알림: JSX에서는 class가 예약된 JavaScript 키워드이므로 className을 사용하세요.

피해야 할 일반적인 실수

  • class 대신 className을 사용.
  • 필요하지 않을 때 Bootstrap의 JavaScript 번들을 가져오는 것.
  • Bootstrap을 다른 UI 라이브러리와 과도하게 결합하여 스타일 충돌을 일으키는 것.

결론

이 가이드에서는 다음 내용을 다루었습니다:

  • Bootstrap이 무엇인지.
  • React 프로젝트에 Bootstrap을 설치하고 가져오는 방법.
  • React 컴포넌트에서 Bootstrap 클래스를 사용하는 방법.

Bootstrap은 초보자, 빠른 프로토타이핑, 그리고 중소 규모 프로젝트에 유용한 도구입니다. 고도로 맞춤화된 디자인에는 적합하지 않을 수 있지만, UI 개발 속도를 높이고 핵심 React 개념에 집중할 수 있게 해줍니다.

중요한 링크

Back to Blog

관련 글

더 보기 »

React를 이용한 계산기

오늘 나는 React를 사용한 계산기 연습 프로젝트 중 하나를 완료했습니다. 이 React Calculator 애플리케이션은 기본 산술 연산을 수행합니다. 버튼을 지원합니다.