Softonic

.gitignore 생성기

단계 1 / 2
프로젝트 기술 스택

이 저장소에서 사용하는 기술 스택을 모두 선택하세요.

개인용 제외 규칙

운영체제와 편집기 관련 규칙은 보통 Git 전역 제외 파일에 넣습니다.

다음: 규칙 검토

저장소에서 사용하는 기술 스택을 선택해 생성 파일, 설치된 의존성, 로컬 환경 파일을 위한 프로젝트용 .gitignore를 만드세요. 여러 스택을 함께 선택할 수 있습니다. 운영체제와 편집기 규칙은 따로 표시되므로 개인 설정은 Git 전역 제외 파일에 넣을 수 있습니다.

제외 규칙 만들고 사용하기

  1. 1

    프로젝트 기술 스택 선택

    저장소에서 사용하는 스택을 모두 선택하세요. 프런트엔드를 빌드하는 PHP 앱이라면 Laravel과 Node.js를 함께 선택할 수 있습니다.

  2. 2

    필요하면 개인용 규칙 추가

    운영체제나 편집기를 선택하면 전역 제외 규칙이 별도로 표시됩니다. 기존 전역 파일에 규칙이 있다면 선택하지 않아도 됩니다.

  3. 3

    검토한 뒤 복사 또는 다운로드

    프로젝트 규칙을 확인하세요. 복사한 내용을 저장소 최상위 디렉터리에 `.gitignore`로 저장하거나, ZIP을 다운로드해 그 안의 `.gitignore`를 같은 위치에 푸세요. 선택한 개인용 규칙은 Git 전역 제외 파일에 넣으세요.

  4. 4

    커밋 전에 다시 확인

    프로젝트의 `.gitignore`를 커밋해 팀원과 공유하세요. 예제 설정 파일과 의존성 잠금 파일처럼 필요한 파일을 Git이 계속 표시하는지 확인하세요.

어떤 규칙을 어디에 넣어야 하나요?

규칙 유형 넣을 위치 예
프로젝트 빌드 결과물과 설치된 의존성 저장소에 커밋하는 .gitignore node_modules/, vendor/, __pycache__/
로컬 환경 값 프로젝트의 .gitignore .env와 로컬용 .env.* 변형
개인 운영체제와 편집기가 만드는 파일 Git 전역 제외 파일 또는 한 저장소에서만 쓰는 .git/info/exclude Finder 메타데이터나 편집기 백업
협업자에게 필요한 파일 필요에 따라 추적 유지 .env.example, package-lock.json, composer.lock, Gemfile.lock

Git은 프로젝트의 .gitignore, 저장소 내부의 .git/info/exclude, 개인 설정의 core.excludesFile을 확인합니다. .gitignore를 커밋하면 프로젝트 규칙이 저장소와 함께 공유됩니다. 개인 규칙은 일반적으로 내 컴퓨터에만 적용됩니다. 자세한 내용은 Git gitignore 설명서와 GitHub 파일 무시 가이드를 참고하세요.

사용 예: Python 스크립트가 포함된 Node.js 서비스

Node.js와 Python을 선택하세요. 프로젝트 파일에는 node_modules/ 같은 설치 패키지, dist/ 같은 Node 빌드 결과물, __pycache__/와 .venv/ 같은 Python 생성 파일을 위한 규칙이 합쳐집니다. 로컬 .env 값도 제외하면서 .env.example은 추적할 수 있게 합니다. Mac과 Visual Studio Code를 쓴다면 해당 개인용 옵션을 선택해 별도로 표시되는 규칙을 확인하세요. 저장하기 전에 두 결과를 실제 저장소와 비교하세요.

생성기는 선택한 템플릿으로 규칙을 만듭니다. 저장소의 파일을 살펴볼 수 없으므로 dist/가 생성 결과물인지, 커밋해야 할 소스인지는 판단하지 못합니다. 프로젝트와 맞지 않는 규칙은 범위를 좁히거나 제거하세요. 추적되지 않은 파일에 적용되는 규칙은 git check-ignore -v path/to/file로 확인할 수 있습니다. GitHub 템플릿 모음은 스택과 편집기 관례를 살펴볼 때 유용하지만, 실제 저장소 검토를 대신하지는 못합니다.

환경 파일과 잠금 파일

.env를 제외하면 로컬 자격 증명이 새 커밋에 들어가는 일을 막는 데 도움이 되지만, 이미 커밋된 비밀 정보가 삭제되지는 않습니다. Git 기록에 들어갔다면 추적을 해제하고 복사된 곳을 확인한 뒤 자격 증명을 교체하세요. .env.example에는 실제 비밀 정보 대신 자리표시자만 들어 있는 경우에만 추적하세요. 생성된 파일에는 포괄적인 .env.* 규칙이 이 예제 파일을 숨기지 않도록 !.env.example 예외가 이미 들어 있습니다. 규칙을 수정할 때도 이 예외를 유지하세요.

애플리케이션에서는 선택한 의존성 버전을 다시 설치할 수 있도록 잠금 파일을 추적하세요. 특히 npm은 package-lock.json 커밋을 권장하고 Composer는 composer.lock 커밋을 권장합니다. 라이브러리는 관례가 다를 수 있으므로 해당 프로젝트의 빌드 및 릴리스 정책을 따르세요.

자주 묻는 질문

제외 규칙은 아직 추적하지 않는 파일에 적용됩니다. 로컬 파일은 남기고 추적만 중단하려면 git rm --cached path/to/file을 실행한 뒤 삭제 내역을 커밋하세요. 자격 증명이 들어 있었다면 이를 교체하고 저장소 기록과 복사본도 확인하세요.

일반적으로 비밀 정보가 제거된 .env.example과 애플리케이션 잠금 파일은 Git에서 추적합니다. 예제 파일은 필요한 환경 변수 이름을 알려 주고, 잠금 파일은 팀과 배포 환경의 의존성 버전을 고정합니다. 예제에 실제 비밀 정보가 없는지 확인하세요.

네. 같은 저장소에서 사용하는 스택을 모두 선택하세요. 선택한 프로젝트 규칙이 하나의 .gitignore로 합쳐집니다. 저장소에서 다른 용도로 사용하는 경로까지 제외하지 않는지 검토하세요.

여러 저장소에 적용할 개인 규칙은 Git 전역 제외 파일에 넣으세요. XDG_CONFIG_HOME이 설정되지 않았다면 Git은 기본적으로 ~/.config/git/ignore를 사용하며, core.excludesFile로 다른 경로를 지정할 수 있습니다. 이 저장소에서만 사용할 비공개 규칙은 .git/info/exclude에 넣으세요. 팀이 해당 규칙을 원하지 않는다면 별도로 표시된 개인 규칙을 공유 프로젝트 파일에 추가하지 마세요.

선택한 기술 스택과 선택 사항인 운영체제 또는 편집기 정보가 규칙 생성에 사용되도록 서버로 전송됩니다. 여러 단계로 진행하는 화면에서는 선택 정보가 페이지 URL에도 표시됩니다. URL에 비밀 정보를 넣지 마세요. 이 도구는 선택에 따라 규칙을 만들며 저장소를 읽거나 파일을 업로드하지 않습니다.

관련 도구

보색 찾기

어떤 입력에 대해서도 보색을 찾습니다. HSL 반대 색, 분할 보색 쌍, 그리고 접근성 있는 조합 제안을 반환합니다.

Webpack 설정 생성기

순수 JavaScript, React, Vue용 webpack 5 webpack.config.js를 만드세요. TypeScript, Babel, CSS 또는 Sass, 이미지, HtmlWebpackPlugin, 개발 서버, npm install 명령까지 함께 제공합니다.

Protocol Buffers 디코더

hex, Base64, Base64URL, 텍스트 또는 파일의 Protobuf 와이어 형식 바이트를 브라우저에서 디코딩하고 정확한 필드 후보를 확인한 뒤 비공개 보고서로 내보냅니다.

XML 포매터

일관된 들여쓰기로 XML 문서를 정렬 출력하고, 정확한 줄 번호로 적격성 오류를 잡아냅니다.

XSD 검증기

XML 문서를 XSD 스키마에 대해 검증하고, 요소와 타입 불일치를 정확한 줄 번호와 함께 보고합니다.

색상 혼합기

두 HEX 색상을 2-20개의 균등한 색상 견본으로 섞습니다. 양 끝 색상을 포함해 각 중간 색상을 대문자 HEX 코드로 확인하세요.

이 도구는 다른 언어로도 제공됩니다