[FastAPI] IntelliJ 환경에서 FastAPI 시작하기

Yang Sooho·2025년 4월 4일


1. Python 플러그인 설치 (한 번만 하면 됨)

  1. IntelliJ 실행
  2. File > Settings (Ctrl+Alt+S) > Plugins
  3. 상단 Marketplace 탭에서 Python 검색
  4. 설치 후 IntelliJ 재시작

2. 새 Python 프로젝트 만들기

  1. File > New Project

  2. 왼쪽에서 Python 선택

  3. 아래 설정:

    • Location: 프로젝트 경로
    • Python Interpreter:
      • 새 가상환경(venv) 만들거나
      • 기존 Python 설치 선택
    • Create 클릭

3. FastAPI + Uvicorn 설치


▶ 터미널 열기

  • IntelliJ 하단의 Terminal 탭 클릭
  • 가상환경이 자동으로 활성화돼 있을 것임
pip install fastapi uvicorn

4. FastAPI 서버 파일 생성

▶ main.py 파일 생성

from fastapi import FastAPI


app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello from IntelliJ + FastAPI!"}

5. 실행 설정 만들기 (Run Configuration)

  1. 메뉴 상단 Run > Edit Configurations
  2. 왼쪽 상단 + 버튼 → FastAPI 선택
  3. 이름: FastAPI
  4. Script path: directories > main.py
  5. Uvicorn 옵션
--reload
  1. Apply > OK

6. 실행

  1. 실행 버튼 클릭

profile
개발 한웅큼 메모 한 스푼

0개의 댓글