🛠️.gitignore 미적용 문제 발생 시 해결방법

🚀 트러블슈팅

백준 사이트로 코딩 테스트를 대비해 공부하던 중,
깃허브와 코드 파일이 적혀있는 인텔리제이 파일을 연동하기 위해 시도했는데 문제 발생해 작성하는 글입니다!

🫥문제 상황

.idea 파일이 함께 업로드되었다😢

😀해결 방법
.gitignore 파일 추가

1. gitignore.io 사이트에서 .gitignore 파일을 만들어주세요.

• 사이트에 접속한 뒤, 본인이 적용할 환경을 작성한 후 생성 버튼을 누르면 텍스트가 보입니다.
  그 텍스트를 command+a 키로 전체 선택 후 command+c로 복사해주세요!
  (윈도우의 경우 command -> control 키)
  ex) 인텔리제이를 사용하고 있고, 언어는 자바인 경우 -> "IntelliJ, Java" 입력

제가 사용한 .gitignore 공유합니다.

# Created by https://www.toptal.com/developers/gitignore/api/intellij,java,gradle
# Edit at https://www.toptal.com/developers/gitignore?templates=intellij,java,gradle

### Intellij ###
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839

# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf

# AWS User-specific
.idea/**/aws.xml

# Generated files
.idea/**/contentModel.xml

# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml

# Gradle
.idea/**/gradle.xml
.idea/**/libraries

# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn.  Uncomment if using
# auto-import.
# .idea/artifacts
# .idea/compiler.xml
# .idea/jarRepositories.xml
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# *.iml
# *.ipr

# CMake
cmake-build-*/

# Mongo Explorer plugin
.idea/**/mongoSettings.xml

# File-based project format
*.iws

# IntelliJ
out/

# mpeltonen/sbt-idea plugin
.idea_modules/

# JIRA plugin
atlassian-ide-plugin.xml

# Cursive Clojure plugin
.idea/replstate.xml

# SonarLint plugin
.idea/sonarlint/

# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties

# Editor-based Rest Client
.idea/httpRequests

# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser

### Intellij Patch ###
# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721

# *.iml
# modules.xml
# .idea/misc.xml
# *.ipr

# Sonarlint plugin
# https://plugins.jetbrains.com/plugin/7973-sonarlint
.idea/**/sonarlint/

# SonarQube Plugin
# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
.idea/**/sonarIssues.xml

# Markdown Navigator plugin
# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
.idea/**/markdown-navigator.xml
.idea/**/markdown-navigator-enh.xml
.idea/**/markdown-navigator/

# Cache file creation bug
# See https://youtrack.jetbrains.com/issue/JBR-2257
.idea/$CACHE_FILE$

# CodeStream plugin
# https://plugins.jetbrains.com/plugin/12206-codestream
.idea/codestream.xml

# Azure Toolkit for IntelliJ plugin
# https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij
.idea/**/azureSettings.xml

### Java ###
# Compiled class file
*.class

# Log file
*.log

# BlueJ files
*.ctxt

# Mobile Tools for Java (J2ME)
.mtj.tmp/

# Package Files #
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar

# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
hs_err_pid*
replay_pid*

### Gradle ###
.gradle
**/build/
!src/**/build/

# Ignore Gradle GUI config
gradle-app.setting

# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
!gradle-wrapper.jar

# Avoid ignore Gradle wrappper properties
!gradle-wrapper.properties

# Cache of project
.gradletasknamecache

# Eclipse Gradle plugin generated files
# Eclipse Core
.project
# JDT-specific (Eclipse Java Development Tools)
.classpath

### Gradle Patch ###
# Java heap dump
*.hprof

# End of https://www.toptal.com/developers/gitignore/api/intellij,java,gradle

2. 텍스트 복사 완료 후, 개발툴에 새로운 파일 저장
   저의 경우 IntelliJ Idea 사용중이기 때문에, 프로젝트의 root 폴더에서 new > file > New File ".gitignore" 입력 후 Enter 했습니다!
   
   

그러면, 다음과 같이 파일이 생성됩니다.

3. 그럼에도 .idea 폴더가 사라지지 않았다?
   ⚠️정확한 해결 방법은 글의 "문제 해결이 안된다 !?" 부분을 참고해주세요! 지금부터 따라하시면 안됩니다!!⚠️

-> .gitignore는 처음 레포지터리 생성 시부터 있어야만 잘 적용된다는 사실을 알게 되었...😢
하지만, 그럼에도 방법은 있죠?

출처 사이트

터미널 접속 후, 다음의 명령어 입력으로 해결 가능하다는 정보를 얻었습니다.

git rm -r --cached .
git add .
git commit -m "clear git cache"
git push

• ⌘+Space로 검생창을 열어주고, terminal 검색
  

• 위 코드 차례대로 입력
  git rm -r --cached .
  
  
  
  
  

git add .
git commit -m "fixed untracked files"

git push

-> fatal: Authentication failed for '원격저장소 주소' 오류가 발생했습니다😮‍💨

해결 방법 링크

깃허브의 정책 변경으로 인해, 기존의 ID/Password 형식의 로그인에서 Token으로 바뀌어 오류가 발생한 것입니다.
Github에서 Settings 접속 & 맨 아래 Developer settings 클릭

아래 순서에 따라 클릭 후,Token 생성

 


다시 터미널로 돌아와서 다음의 과정을 거칩니다.
git config --global user.name 'hayannn'

git config --global user.password '복사한 Token 붙여넣기'

git push
-> 이때, 다시 한번 계정 정보를 묻는다면 계정의 아이디와 Token 값을 비밀번호로 사용해서 적용하시면 됩니다.

문제 해결이 안된다 ⁉️

Github 레포지터리에 들어가 확인해보니, 적용이 안되어 있어 다른 방법을 시도했습니다!

별도의 Mac 터미널이 아닌 -> 인텔리제이의 터미널에서 바로 적용!

성공!

.idea 폴더가 업로드되지 않도록 .gitignore이 적용되었습니다!

🤭 정리

🙋 .idea를 Github 업로드 시 없애야 하는 이유는 무엇인가요?
💁‍♀️ .idea에는 프로젝트의 버전 등이 포함되어 있는데, 이것이 중복되어 commit 될 경우, 본인 혹은 타 사용자가 clone하여 사용할 시 버전 충돌이 발생할 수 있습니다.

어떻게 알았냐구요?
저도 알고 싶지 않았습니다....👼

🙋 .idea를 이미 레포지터리에 commit 했다면?
💁‍♀️ 해당 개발툴 내의 Teminal에서 다음을 차례대로 입력해주세요.

git rm -r --cached .
git add .
git commit -m "clear git cache"
git push

앞으로도 정말 Git은 많이 공부해야겠습니다...!

모두들 파이팅👏