[Git] .gitignore 사용법/원하는 파일만 github에 등록하고 싶을 때!/Git Desktop

 

 

 

안녕하세요!

데이터 분석 프로젝트를 실행하는 중에

분석할 파일(개인정보 多), 분석 결과 등을 제외하고 원하는 코드 파일만 github에 등록할 수 있는 방법이 없을까? 하고 고민하다가, 

ChatGPT의 추천을 받아 .gitignore 파일을 작성해보기로 했답니다.

 

포트폴리오 웹 사이트를 만들면서도 해당 파일을 만들어 등록해보기는 했는데

직접 손수 한땀한땀 처음부터 끝까지 작성해본 적은 없더라고요.

 

직접 작성해보면 분명 나중에 쓸 일이 있을 것도 같고, 해당 파일에 대한 이해도를 높일 수 있을 것 같아

이번 게시글에서는 .gitignore 작성법에 대해 다뤄보고자 합니다.

 

---

.gitignore

Git은 기본적으로 모든 파일을 추적합니다.

하지만

- 빌드 결과물

- 환경 설정 파일

- 캐시 파일

- 개인 정보 파일

등 추적할 필요가 없는 파일들이 존재하죠.

.gitignore 파일을 사용하면 이러한 불필요한 파일이 Git의 변경 사항 추적에 포함되지 않도록 설정할 수 있다고 합니다.

 

해당 파일은 프로젝트에 루트 디렉터리에 작성하면 되며, 

무시할 파일 또는 디렉터리의 패턴을 한 줄씩 작성하면 됩니다.

 

 

Git에게 “이 파일/폴더는 추적하지 마”라고 알려주는 목록

• 로컬에는 있음 ⭕
• GitHub에는 안 올라감 ❌

가장 기본 규칙 

🔹 파일 무시

secret.txt config.json

 

→ 해당 이름의 파일 무시

---

🔹 확장자 무시

*.csv *.log *.tmp

 

→ 모든 csv, log, tmp 파일 무시

---

🔹 폴더 무시

data/ outputs/ venv/

 

→ 해당 폴더 전체 무시

📌 끝에 / 붙이면 “폴더” 의미

---

3️⃣ 자주 쓰는 핵심 패턴 (중요 ⭐)

🔸 * (와일드카드)

*

 

→ 전부 무시

(이거 하나로 “화이트리스트 방식” 가능)

---

🔸 ! (예외 허용)

* !README.md

 

→ 전부 무시하되
→ README.md만 추적

---

🔸 디렉토리 구조 유지

!*/

 

→ 폴더는 살리고
→ 파일만 무시

이거 모르면 “폴더가 안 보임” 현상 생김

---

4️⃣ 경로 기준 패턴

🔹 특정 폴더 아래만 무시

data/raw/

---

🔹 어디에 있든 이름 같으면 무시

**/secrets.txt

---

🔹 특정 경로만 허용

data/* !data/README.md

---

5️⃣ 실무에서 가장 많이 보는 세트

🐍 Python 프로젝트 기본형

__pycache__/ *.pyc *.pyo venv/ .venv/ .env

---

💻 OS / IDE

.DS_Store .vscode/ .idea/

---

📊 데이터 분석

data/ outputs/ *.csv *.xlsx

 

---

6️⃣ ⚠️ 제일 중요한 사실 (진짜 중요)

❗ .gitignore는 “이미 올라간 파일”에는 효과 없음

이 상태:

(이미 git에 추가됨)

나중에 .gitignore에 써도:
❌ 안 사라짐

---

이미 추적 중인 파일 제거 방법

git rm --cached 파일명 git commit -m "Remove ignored file"

 

(로컬 파일은 유지됨)

---

7️⃣ 내가 자주 쓰는 사고방식 (이걸로 충분)

❌ “이걸 제외할까?”
⭕ “이걸 공개해도 되나?”

공개해도 되는 것만:

• 코드
• README
• 실행 스크립트

나머지는:

• 데이터
• 환경
• 결과물
  → 전부 ignore

 

---

참고 문헌

https://wikidocs.net/277237