IT Talk

Categories: IT 팁

Flask 설치 방법 OS별 총정리, 초보도 쉽게!

Flask는 최근 웹 개발에서 많이 사용되는 파이썬 기반의 간단한 웹 프레임워크입니다. Flask는 가볍고 유연하여, 빠르게 웹 애플리케이션을 만들고 싶은 사람들에게 좋은 선택입니다. 이 가이드에서는 Flask 설치부터 기본 사용법까지 쉽게 설명해 드리겠습니다.

단계별 설치 가이드

단계	설명
1. Python 설치 확인	컴퓨터에 Python이 설치되어 있는지 확인합니다.
2. 가상환경 설정	프로젝트별 독립적인 환경을 위해 가상환경을 만듭니다.
3. Flask 설치	pip를 사용해서 Flask를 설치합니다.
4. 설치 확인	Flask가 제대로 설치되었는지 확인합니다.
5. 기본 애플리케이션 작성	간단한 Flask 애플리케이션을 만듭니다.
6. 애플리케이션 실행	만든 애플리케이션을 실행합니다.
7. 브라우저에서 확인	웹 브라우저에서 애플리케이션이 잘 동작하는지 확인합니다.
8. 추가 설정	필요에 따라 환경 변수를 설정합니다.
9. 개발 도구 연동	VSCode와 같은 개발 도구와 연결하는 방법을 알아봅니다.
10. 플랫폼별 설치	Windows, macOS, Linux 등 여러 플랫폼에서의 설치 방법을 설명합니다.

1. Python 설치 확인

Flask는 Python으로 만들어졌기 때문에, 먼저 컴퓨터에 Python이 설치되어 있는지 확인해야 합니다. 터미널이나 명령 프롬프트를 열고 아래 명령어를 입력하세요:

python --version

또는

python3 --version

위 명령어로 Python 버전이 출력되면, Python이 설치된 것입니다. 만약 설치되어 있지 않다면, Python 공식 웹사이트에서 최신 버전을 다운로드해 설치하세요.

Python은 웹 애플리케이션을 개발하는 데 있어서 필수적인 도구입니다. Python이 설치되지 않으면 Flask를 사용할 수 없기 때문에, 먼저 설치 여부를 꼭 확인해야 합니다. Python이 올바르게 설치되면, 다음 단계로 넘어갈 수 있습니다. Python의 최신 버전을 설치하는 것이 좋습니다. 최신 버전에서는 보안과 기능이 개선되어 더 나은 성능을 제공합니다.

2. 가상환경 설정

프로젝트마다 독립적인 패키지 관리를 위해 가상환경을 사용하는 것이 좋습니다. 가상환경을 만들려면, 원하는 프로젝트 폴더로 이동한 후 아래 명령어를 입력하세요:

python -m venv venv

여기서 venv는 가상환경의 이름으로, 원하는 이름으로 바꿀 수 있습니다.

가상환경을 사용하는 이유는 프로젝트마다 필요한 패키지가 다를 수 있기 때문입니다. 가상환경을 설정하면 프로젝트 간의 패키지 충돌을 방지할 수 있고, 특정 프로젝트에만 필요한 라이브러리를 독립적으로 관리할 수 있습니다. 이를 통해 개발 환경을 좀 더 깨끗하게 유지할 수 있으며, 필요에 따라 다른 Python 버전도 사용할 수 있게 됩니다.

가상환경을 활성화하려면, 운영체제에 따라 아래 명령어를 사용하세요:

Windows:

  venv\Scripts\activate

macOS/Linux:

  source venv/bin/activate

가상환경이 활성화되면, 프롬프트 앞에 (venv)와 같은 표시가 나타납니다. 이 상태에서 필요한 라이브러리를 설치하면, 해당 가상환경 안에서만 적용되므로 다른 프로젝트에 영향을 미치지 않습니다. 가상환경을 종료하려면 다음 명령어를 사용하세요:

deactivate

3. Flask 설치

가상환경이 활성화된 상태에서, pip를 사용해서 Flask를 설치합니다:

pip install Flask

Flask는 간단하고 사용하기 쉬운 웹 프레임워크로, 빠르게 웹사이트를 개발할 수 있도록 도와줍니다. Flask를 설치한 후에는 다음 명령어로 설치된 Flask의 버전을 확인할 수 있습니다:

python -m flask --version

버전 정보가 출력되면, Flask가 성공적으로 설치된 것입니다. Flask를 설치하는 과정에서 pip가 최신 버전이 아니라면 업데이트하는 것이 좋습니다. pip를 최신 상태로 유지해야 라이브러리를 설치하거나 업데이트할 때 문제가 발생하지 않습니다.

4. 기본 애플리케이션 작성

이제 간단한 Flask 애플리케이션을 만들어보겠습니다. 프로젝트 폴더에 app.py라는 파일을 만들고 아래와 같이 작성하세요:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, World!'

위 코드에서 @app.route('/')는 웹사이트의 기본 경로(‘/’)에 접속했을 때 hello_world 함수를 실행하라는 의미입니다. Flask 애플리케이션은 라우팅을 통해 사용자가 웹사이트의 특정 URL에 접속했을 때 어떤 페이지를 보여줄지 결정합니다. 이 기본 애플리케이션은 사용자가 홈페이지에 접속했을 때 “Hello, World!” 메시지를 표시하게 됩니다.

함수명은 자유롭게 변경할 수 있지만, 라우팅 경로와 반환되는 값이 적절히 맞춰져야 합니다. 더 복잡한 애플리케이션을 만들고 싶다면 다른 경로와 함수를 추가하여 여러 페이지를 지원할 수 있습니다.

5. 애플리케이션 실행

애플리케이션을 실행하려면, 터미널에서 아래 명령어를 입력하세요:

flask run

만약 환경 변수를 설정하지 않았다면, 아래와 같이 FLASK_APP 변수를 지정한 후 실행해야 합니다:

export FLASK_APP=app
flask run

Windows에서는:

set FLASK_APP=app
flask run

애플리케이션이 실행되면, 아래와 같은 메시지가 나타납니다:

 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

이 메시지는 애플리케이션이 정상적으로 실행되고 있다는 것을 의미합니다. 이제 웹 브라우저를 열어 http://127.0.0.1:5000/에 접속하면 애플리케이션을 확인할 수 있습니다.

6. 브라우저에서 확인

웹 브라우저를 열고 http://127.0.0.1:5000/에 접속하면, “Hello, World!”라는 메시지가 화면에 표시됩니다. 이렇게 해서 기본적인 Flask 애플리케이션이 성공적으로 동작하는 것을 확인할 수 있습니다.

Flask는 기본적으로 로컬 서버에서 실행되기 때문에, 다른 컴퓨터에서는 접속할 수 없습니다. 로컬 개발용으로 사용되는 것이므로 외부 사용자를 위한 프로덕션 서버로 사용하려면 추가 설정이 필요합니다. 예를 들어, 웹 애플리케이션을 배포하려면 Gunicorn과 같은 WSGI 서버를 사용하는 것이 좋습니다.

7. 추가 설정

개발 중에는 디버그 모드를 활성화하면 코드 변경 시 자동으로 서버가 업데이트되어 편리합니다. 디버그 모드를 활성화하려면, 환경 변수를 설정한 후 실행하세요:

export FLASK_ENV=development
flask run

Windows에서는:

set FLASK_ENV=development
flask run

디버그 모드를 활성화하면 오류가 발생했을 때 상세한 오류 메시지를 브라우저에서 확인할 수 있어 문제 해결에 도움이 됩니다. 개발자 도구와 결합하면 더욱 효율적으로 버그를 수정할 수 있습니다.

8. 개발 도구 연동

VSCode와 같은 개발 도구를 사용하면 Flask 개발이 훨씬 편리합니다. VSCode에서 Python 가상환경을 설정하고, 필요한 플러그인을 설치해 효율적으로 개발을 진행할 수 있습니다. Python 플러그인 외에도 Flask와 잘 맞는 여러 유용한 확장 기능들이 있어 개발 시간을 단축하고 코딩 경험을 향상시킬 수 있습니다.

예를 들어, 코드 자동 완성 기능을 사용하면 Flask의 여러 기능을 쉽게 탐색할 수 있고, 오류 표시 기능을 통해 코드의 문제점을 빠르게 발견할 수 있습니다. 개발 도구와 가상환경을 잘 연동하면 여러 프로젝트를 동시에 관리하기에도 매우 유용합니다.

9. 플랫폼별 설치

Windows에서 Flask 설치

단계	설명
1. Python 설치 확인	Python 공식 웹사이트에서 설치 파일을 다운로드하고 설치하세요. 설치할 때 `Add Python to PATH` 옵션을 선택하세요.
2. 가상환경 생성 및 Flask 설치	“`bash
python -m venv venv
venv\Scripts\activate
pip install Flask

|
| **3. Flask 실행** | ```bash
set FLASK_APP=app
flask run

Windows 환경에서는 Python 설치 시 Add Python to PATH 옵션을 반드시 체크해야 명령 프롬프트에서 Python을 인식할 수 있습니다. 가상환경을 만들고 활성화한 후 Flask를 설치하면, 독립된 개발 환경을 구축할 수 있어 다른 프로젝트에 영향을 주지 않고 개발을 진행할 수 있습니다.

macOS에서 Flask 설치

단계	설명
1. Python 설치	macOS 기본 Python 대신 Python 공식 웹사이트에서 설치하세요. Homebrew를 사용해 설치할 수도 있습니다: `brew install python`
2. 가상환경 생성 및 Flask 설치	“`bash
python3 -m venv venv
source venv/bin/activate
pip install Flask

|
| **3. Flask 실행** | ```bash
export FLASK_APP=app
flask run

macOS 환경에서는 Python3가 기본으로 설치되어 있는 경우가 많지만, 최신 버전이 아닐 수 있습니다. Homebrew를 사용하면 Python을 쉽게 설치하고 관리할 수 있으며, 여러 버전의 Python을 동시에 사용할 수도 있습니다. 가상환경을 통해 프로젝트마다 독립적으로 개발을 진행할 수 있으며, Flask 설치 후 실행하여 애플리케이션을 개발할 수 있습니다.

결론 및 다음 단계

이 가이드를 따라서 Flask 설치부터 기본 애플리케이션 실행까지 할 수 있습니다. 다양한 플랫폼에서 Flask 설치 방법을 설명했으니, 자신의 환경에 맞춰 시작해 보세요. Flask는 초보자도 쉽게 시작할 수 있을 만큼 간단하지만, 복잡한 웹 애플리케이션도 충분히 개발할 수 있는 강력한 도구입니다.

Flask로 웹 애플리케이션 개발을 시작했다면, 다음 단계로는 데이터베이스와 연동하여 좀 더 복잡한 기능을 추가해 보는 것을 추천합니다. 예를 들어, SQLAlchemy와 같은 ORM(Object Relational Mapping) 도구를 사용하면 데이터베이스와의 상호작용을 쉽게 할 수 있습니다. 또한, Flask Blueprints를 사용하여 애플리케이션을 여러 모듈로 나누어 관리하면 더 크고 복잡한 프로젝트도 쉽게 유지할 수 있습니다.

추가 학습 자료 및 다음 콘텐츠

추가 학습 자료: Flask 공식 문서(공식 사이트)에서 더 많은 정보를 확인하세요. 공식 문서에는 Flask의 모든 기능과 설정 방법이 자세히 설명되어 있어, 다양한 기능을 배우는 데 큰 도움이 됩니다.
다음 추천 콘텐츠: Flask와 함께 사용하는 데이터베이스 설정 가이드도 확인해보세요! 데이터베이스는 웹 애플리케이션의 중요한 부분 중 하나이며, 데이터를 저장하고 관리하는 방법을 배우는 것은 매우 중요합니다. 이를 통해 더 유용하고 강력한 웹 애플리케이션을 개발할 수 있습니다.

Flask는 매우 유연한 프레임워크로, 필요에 따라 다양한 확장 기능을 추가할 수 있습니다. 로그인 시스템, 폼 처리, 파일 업로드 등 실전 프로젝트에서 많이 사용하는 기능들을 배우고 추가해 보세요. 이러한 과정들을 통해 Flask에 대한 이해를 높이고, 실제 웹사이트 개발 경험을 쌓을 수 있습니다.

본 문서의 설치 명령어는 최신 기준으로 작성되었습니다. 특정 시스템 환경에서는 추가 설정이 필요할 수 있습니다. Flask를 설치하고 실행하는 과정에서 문제가 발생할 경우, 오류 메시지를 잘 확인하고 Flask 공식 문서나 관련 커뮤니티에서 해결 방법을 찾아보세요. 문제가 잘 해결되지 않는 경우, Python과 pip의 버전을 다시 확인하고 필요한 경우 업데이트하는 것도 좋은 방법입니다.

Flask를 이용해 즐겁고 유익한 웹 개발 여정을 시작해 보세요! 😊

IT talk