Python 가상화 환경을 GitHub과 연동하여 관리하는 방법 (Visual Studio Code 기준)

안녕하세요, 여러분! 오늘은 파이썬 가상화 환경을 GitHub과 연동하여 프로젝트를 관리하는 방법에 대해 알아보겠습니다. Visual Studio Code(이하 VS Code)를 기준으로 설명드릴 테니, 따라하기 쉽고 재미있게 진행해보세요!

1. 준비물

• Python: 파이썬이 설치되어 있어야 합니다. 터미널에서 python --version으로 확인해보세요.
• VS Code: 최신 버전의 Visual Studio Code를 설치하세요. (링크)
• Git: Git이 설치되어 있어야 합니다. git --version으로 확인해보세요.
• GitHub 계정: GitHub 계정이 필요합니다. 계정이 없다면 GitHub 가입하기에서 가입하세요.

 

2. 프로젝트 폴더 생성 및 가상 환경 설정

2.1. 프로젝트 폴더 생성

VS Code를 열고, 새로운 폴더를 생성합니다. 이 폴더가 여러분의 프로젝트가 될 것입니다.

2.2. 가상 환경 생성

VS Code의 터미널을 열고(상단 메뉴: Terminal > New Terminal), 아래 명령어를 입력하여 가상 환경을 생성합니다.

bash

python -m venv venv

위 명령어는 venv라는 이름의 가상 환경을 생성합니다. 가상 환경의 이름은 자유롭게 변경할 수 있습니다.

2.3. 가상 환경 활성화

가상 환경을 활성화합니다. 아래 명령어를 입력하세요.

• Windows:

bash

venv\Scripts\activate

• MacOS/Linux:

bash

source venv/bin/activate

가상 환경이 활성화되면 터미널 프롬프트에 (venv)가 표시됩니다.

3. Git 초기화 및 첫 커밋

3.1. Git 초기화

프로젝트 폴더에서 Git을 초기화합니다. 아래 명령어를 입력하세요.

bash

git init

이 명령어를 입력하면 .git이라는 숨겨진 폴더가 생성됩니다. 이 폴더는 Git이 버전 관리를 위해 사용하는 데이터입니다.

3.2. .gitignore 파일 생성

가상 환경과 관련된 파일은 Git에 포함시키지 않도록 .gitignore 파일을 생성합니다. 프로젝트 루트 디렉토리에 .gitignore 파일을 만들고, 아래 내용을 추가합니다.

venv/
__pycache__/
*.pyc

이렇게 하면 가상 환경 폴더와 불필요한 캐시 파일이 Git에 포함되지 않습니다.

3.3. 첫 커밋하기

변경 사항을 추가하고 첫 커밋을 합니다. 아래 명령어를 입력하세요.

bash

git add .
git commit -m "Initial commit"

4. GitHub에 리포지토리 생성하기

이제 GitHub에 새로운 리포지토리를 생성합니다.

1. GitHub에 로그인한 후, 오른쪽 상단의 + 버튼을 클릭하고 New repository를 선택합니다.
2. 리포지토리 이름을 입력하고, Create repository 버튼을 클릭합니다.

5. 로컬 리포지토리와 GitHub 연동하기

5.1. 원격 리포지토리 추가

생성한 GitHub 리포지토리의 URL을 복사한 후, VS Code의 터미널에서 아래 명령어를 입력하여 원격 리포지토리를 추가합니다.

bash

git remote add origin <리포지토리 URL>

 

예를 들어, 리포지토리 URL이 https://github.com/username/repo.git라면 아래와 같이 입력합니다.

bash

git remote add origin https://github.com/username/repo.git

5.2. 코드 푸시하기

이제 로컬 리포지토리의 코드를 GitHub로 푸시합니다. 아래 명령어를 입력하세요.

bash

git push -u origin master

이제 여러분의 코드가 GitHub에 올라갔습니다!

6. VS Code에서 Git 관리하기

VS Code에는 Git을 쉽게 관리할 수 있는 기능이 내장되어 있습니다. 왼쪽 사이드바에서 Git 아이콘(또는 Ctrl + Shift + G)을 클릭하면 변경 사항을 쉽게 확인하고 커밋할 수 있습니다.

• 변경 사항 확인: 수정된 파일이 표시됩니다.
• 커밋: 커밋 메시지를 입력하고 ✓ 아이콘을 클릭하여 커밋합니다.
• 푸시: 상단의 세 개의 점 아이콘을 클릭하여 Push를 선택하면 GitHub에 푸시할 수 있습니다.

7. 마치며

이제 Python 가상화 환경을 GitHub과 연동하여 관리하는 방법을 배웠습니다! 이 과정을 통해 프로젝트를 잘 관리하고, 다른 사람들과 협업할 수 있는 기반을 마련할 수 있습니다.

질문이 있다면 댓글로 남겨주세요! 다음에도 유용한 팁으로 찾아뵙겠습니다. 행복한 코딩 되세요! 😊