2025.01.13 TIL - GIT / Django 서버 실행

오늘의 TIL (Today I Learned)

1. Git과 VSCode 연동법

• 설치 및 설정:
  1. Git 설치: Git 공식 사이트에서 다운로드 후 설치.
  2. VSCode에서 Git 연동 확인: Ctrl + ~을 눌러 터미널 열기 → git --version으로 설치 확인.
  3. 초기 설정:

     git config --global user.name "Your Name"
     git config --global user.email "your.email@example.com"
     

• VSCode 내 연동:
  1. VSCode 내 연동:
     1. 프로젝트 폴더를 열고 `Ctrl + Shift + P` → "Git: Clone" 선택.
     2. 원격 레포지토리 URL 입력 → 클론 완료 후 작업 폴더 열기.
     3. 원격 레포지토리 URL은 GitHub 또는 GitLab에서 제공하는 HTTPS 주소를 복사해서 사용 가능합니다.
        - 예: `https://github.com/username/repository.git`

---

2. VSCode 내 가상환경 만드는 법

• 가상환경 생성:
  1. 프로젝트 폴더에서 터미널 열기 (Ctrl + ~).
  2. 가상환경 생성 명령 실행:

     python -m venv [venv: 꼭 venv일 필요 없이 직접 디렉토리 이름 설정 가능]   
     
     ##명령어 구조 설명##:
     python -m venv venv
     
     1.python: Python 실행 명령어.
     2.-m venv: Python의 표준 모듈인 venv를 사용하겠다는 의미입니다. 이 모듈은 가상환경을 생성하는 데 사용됩니다.
     3. venv: 생성할 가상환경의 디렉토리 이름입니다.

  3. 가상환경 활성화:
     • Windows:

       .\venv\Scripts\activate
       
       
       ##다른 방법##
       
       Windows에서 **가상환경 활성화** 명령어를 입력할 때, `.\`를 생략하고 `venv\Scripts\activate`를 사용해도 동작합니다. 
       하지만 아래 이유로 `.\`를 포함하는 것이 권장됩니다:
       
       ---
       
       ### 1. **`.\`의 의미**
       - `.\`는 현재 디렉토리를 나타내는 상대 경로입니다.
       - Windows에서 명령어 실행 시, 현재 디렉토리의 스크립트를 명시적으로 호출할 때 사용됩니다.
       
       예:
       ```bash
       .\venv\Scripts\activate
       ```
       위 명령은 현재 디렉토리(`.`)에서 `venv\Scripts\activate` 파일을 실행하도록 지정합니다.
       
       ---
       
       ### 2. **왜 `venv\Scripts\activate`도 동작하나요?**
       Windows 명령 프롬프트(CMD)에서는 현재 디렉토리에서 파일을 찾기 때문에, `.\`를 생략해도 작동합니다:
       ```bash
       venv\Scripts\activate
       ```
       이는 명령어가 기본적으로 현재 디렉토리에서 시작한다고 가정하기 때문입니다.
       
       ---
       
       ### 3. **`.\` 사용을 권장하는 이유**
       1. **명확성:** 현재 디렉토리에서 파일을 실행하는 것을 명확히 나타냅니다.
       2. **호환성:** PowerShell이나 다른 터미널 환경에서는 `.\`가 필수인 경우가 있습니다.
          - PowerShell:
            ```bash
            .\venv\Scripts\activate
            ```
       3. **버그 방지:** 다른 경로에 동일한 이름의 파일이 있을 경우, 잘못된 파일이 실행되는 것을 방지합니다.
       
       ---
       
       ### 결론
       - **`venv\Scripts\activate`**도 작동하지만, **`.\venv\Scripts\activate`**를 사용하는 것이 더 안전하고 권장됩니다.
       - PowerShell이나 다른 환경에서도 동일한 명령어를 사용할 수 있어 일관성을 유지할 수 있습니다.
       
       #### 요약:
       ```bash
       .\venv\Scripts\activate  # 권장
       venv\Scripts\activate    # CMD에서는 작동
       ```

     • macOS/Linux:

       source venv/bin/activate
       

• VSCode와 연동:
  1. VSCode 하단의 Python 인터프리터 선택 버튼 클릭 → "Interpreter 선택"에서 생성한 가상환경 선택.
  2. 자동 활성화를 위해 .vscode/settings.json에 다음 내용 추가:

     {
       "python.pythonPath": "./venv/bin/python"
     }
     

---

3. 가상환경과 GitHub 원격 조정

• .gitignore 설정:
  1. .gitignore 파일 생성 후 아래 내용 추가:

     venv/
     __pycache__/
     *.pyc
     *.pyo
     

  2. git init으로 로컬 저장소 생성 후 GitHub에 Push:

     git add .
     git commit -m "Initial commit"
     git branch -M main
     git remote add origin <GitHub_Repo_URL>
     git push -u origin main
     

---

4. Django runserver까지 과정

• Django 프로젝트 생성:
  1. Django 설치:

     pip install django
     

  2. Django 프로젝트 생성:

     django-admin startproject <myproject: 프로젝트 폴더명> .

  3. 앱 생성:

     python manage.py startapp myapp
     

• runserver 실행:
  1. settings.py에 앱 등록:

     INSTALLED_APPS = [
         # Default apps...
         'myapp',
     ]
     

  2. 데이터베이스 마이그레이션:

     python manage.py migrate
     

  3. 개발 서버 실행:

     python manage.py runserver
     

---

코드 요약

# Git 초기 설정
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 가상환경 생성 및 활성화
python -m venv venv
# Windows
.\venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# Django 프로젝트 설정
pip install django
django-admin startproject myproject .
python manage.py startapp myapp

# 서버 실행
python manage.py runserver

배운 점

• Git 연동: 원격 저장소와 협업의 시작점을 배웠다.
• 가상환경 관리: 프로젝트 독립성을 유지할 수 있다.
• Django: 앱 구조와 기본 서버 실행 과정 이해.