[Unity] Vscode unity에 연결해도 안될때. extension 적용 안될 때. 코드 색깔 안바뀔 때.

Unity VSCode 연결 안될 때 해결 방법 완벽 정리

안녕하세요 여러분~

오늘은 Unity 쓰다가 진짜 열받는 문제 하나 해결해볼게요. 바로 VSCode가 Unity랑 연결이 안 되는 문제입니다 ㅠㅠ

코드 색깔도 안 바뀌고, 자동완성도 안 되고, 에러도 안 잡아주고... 완전 답답하죠? 저도 처음에 이거 때문에 삼일 동안 고생했어요 진짜 ㅋㅋㅋ

그런데 의외로 해결 방법은 간단했답니다. 바로 Unity의 Package Manager에서 Visual Studio Code Editor 패키지를 업데이트하면 되는 거였어요!

왜 이런 문제가 생기는 걸까

Unity에서 VSCode 연결이 안 되는 이유는 주로 Visual Studio Code Editor 패키지 버전이 너무 구식이기 때문이에요. Unity랑 VSCode가 서로 대화하려면 중간에서 연결해주는 패키지가 필요한데, 이게 옛날 버전이면 제대로 작동을 안 하는 거죠.

특히 Unity 2021 이후 버전을 쓰시는 분들은 Visual Studio Editor 패키지를 2.0.20 버전 이상으로 업데이트해야 해요. 그 밑 버전들은 legacy 패키지라서 이제 관리도 안 된답니다 완전.

해결 방법 1번 - 패키지 업데이트 (가장 중요!)

자 그럼 이제 본격적으로 문제를 해결해볼까요?

Unity Package Manager 열기

먼저 Unity 에디터에서 Window > Package Manager 를 클릭해주세요. 요거 열면 Unity에 설치된 패키지들이 쭉 나옵니다.

Visual Studio Editor 패키지 찾기

Package Manager 창 왼쪽 위에 보면 드롭다운 메뉴가 있을 거예요. 요거를 Unity Registry 로 바꿔주세요. 그럼 Unity에서 공식적으로 제공하는 패키지들이 보입니다.

여기서 Visual Studio Editor 패키지를 찾아주세요. 주의할 점은 Visual Studio Code Editor 가 아니라 Visual Studio Editor 라는 점!! Visual Studio Code Editor는 옛날 패키지라서 이제 안 쓴답니다~

업데이트 버튼 클릭

Visual Studio Editor 패키지를 선택하면 오른쪽에 패키지 정보가 나와요. 여기서 버전을 확인해보시고, 업데이트 버튼이 보이면 바로 클릭해주세요!

최소 2.0.20 버전 이상으로 업데이트해야 해요. 최신 버전은 2.0.26까지 나왔더라구요. 업데이트하면 Unity VSCode 연결이 훨씬 안정적으로 작동합니다.

Unity 재시작

패키지 업데이트가 끝나면 Unity를 완전히 종료했다가 다시 켜주세요. 요거 안 하면 업데이트가 제대로 적용 안 될 수 있어요.

해결 방법 2번 - External Script Editor 설정 확인

패키지 업데이트했는데도 Unity VSCode 연결이 안 된다면? 요런 경우엔 Unity 설정에서 VSCode가 제대로 선택되어 있는지 확인해봐야 해요.

Preferences 열기

Unity 에디터 상단 메뉴에서 Edit > Preferences (Mac은 Unity > Preferences) 를 클릭해주세요.

External Tools 설정

Preferences 창이 열리면 왼쪽 메뉴에서 External Tools 를 찾아 클릭하세요.

여기서 External Script Editor 항목을 보면 어떤 에디터를 사용할지 선택할 수 있어요. 요거를 Visual Studio Code 로 바꿔주세요. 만약 목록에 VSCode가 안 보인다면 Browse 를 눌러서 직접 VSCode 실행 파일을 찾아주면 됩니다.

해결 방법 3번 - 프로젝트 파일 재생성

그래도 Unity VSCode 연결이 안 된다구요? 그럼 이제 프로젝트 파일을 다시 생성해봐야 해요.

Unity는 VSCode한테 프로젝트 정보를 알려주기 위해서 .csproj 파일이랑 .sln 파일을 만들어요. 근데 이 파일들이 꼬이면 Unity VSCode 연결이 제대로 안 될 수 있답니다.

Regenerate project files 버튼 찾기

아까 열었던 Edit > Preferences > External Tools 로 다시 가주세요. 여기 밑으로 쭉 내려가면 Regenerate project files 라는 버튼이 있을 거예요.

요 버튼을 누르면 Unity가 프로젝트 파일들을 싹 다시 만들어줍니다. Embedded packages랑 Local packages는 체크해주는 게 좋아요. Registry packages는 필요하면 체크하시구요.

Unity와 VSCode 재시작

프로젝트 파일 재생성이 끝나면 Unity랑 VSCode를 둘 다 완전히 종료했다가 다시 켜주세요. 그 다음에 Unity에서 스크립트 파일을 더블클릭해서 VSCode가 제대로 열리는지 확인해보세요!

해결 방법 4번 - VSCode 확장 프로그램 설치

혹시 VSCode에 Unity 관련 확장 프로그램을 설치 안 하셨나요? Unity VSCode 연결을 위해선 필수 확장 프로그램들이 있어요.

필수 확장 프로그램 목록

VSCode 왼쪽 메뉴에서 확장 프로그램 아이콘을 클릭하고, 아래 확장들을 검색해서 설치해주세요.

1. C# Dev Kit (Microsoft 제공)
2. Unity (Microsoft 제공)
3. C# (Microsoft 제공)

요 세 개만 설치하면 Unity VSCode 연결에 필요한 기능들이 다 들어가요. 예전엔 OmniSharp 같은 확장도 따로 설치해야 했는데, 이제는 C# Dev Kit에 다 포함되어 있답니다.

로그인 필요

C# Dev Kit이랑 Unity 확장을 쓰려면 Microsoft 계정으로 로그인해야 해요. 개인 사용이나 오픈소스 개발은 무료니까 걱정 마세요! VSCode 왼쪽 아래에 계정 아이콘 보이죠? 요거 클릭해서 로그인하시면 됩니다.

해결 방법 5번 - .NET SDK 설치 확인

Unity VSCode 연결이 잘 안 되는 또 다른 이유는 .NET SDK가 설치 안 되어 있어서일 수도 있어요.

VSCode에서 C# 코드를 이해하고 자동완성을 해주려면 .NET SDK가 필요한데요, 이게 없으면 Unity VSCode 연결이 되어도 제대로 작동을 안 해요.

Windows 사용자

Windows 쓰시는 분들은 .NET Framework 4.7.1 Developer Pack 이상을 설치해주세요. Microsoft 공식 사이트에서 다운받을 수 있어요.

Mac 사용자

Mac 쓰시는 분들은 .NET SDK랑 Mono 최신 버전을 설치해주세요. 요것도 역시 공식 사이트에서 다운 가능합니다!

완전 안 될 때 최후의 수단

여기까지 다 해봤는데도 Unity VSCode 연결이 안 된다? 그럼 이제 진짜 최후의 수단을 써봐야 해요 ㅠㅠ

완전 재설치

1. VSCode 완전히 삭제
2. Unity Hub에서 프로젝트 닫기
3. 프로젝트 폴더에서 .vs 폴더, .vscode 폴더, .sln 파일, .csproj 파일 전부 삭제
4. Library 폴더 삭제 (요거 삭제하면 Unity가 프로젝트를 다시 임포트해요)
5. VSCode 재설치
6. Unity에서 프로젝트 다시 열기
7. Package Manager에서 Visual Studio Editor 패키지 최신 버전으로 업데이트
8. External Tools 설정에서 VSCode 다시 설정
9. 프로젝트 파일 재생성

요 순서대로 하면 완전 깨끗하게 다시 시작할 수 있어요. 귀찮긴 하지만 대부분은 요 방법으로 해결된답니다!

정리하자면

Unity VSCode 연결 안 될 때는 이렇게 해보세요!

순서	해결 방법	난이도
1	Package Manager에서 Visual Studio Editor 패키지 업데이트	쉬움
2	External Script Editor 설정 확인	쉬움
3	프로젝트 파일 재생성	보통
4	VSCode 확장 프로그램 설치	보통
5	.NET SDK 설치 확인	보통
6	완전 재설치	어려움

대부분은 1번 방법인 Visual Studio Editor 패키지 업데이트만 해도 Unity VSCode 연결이 바로 해결돼요. 진짜 간단하죠? ㅎㅎ

저도 처음엔 몰라서 VSCode 지웠다 깔았다 엄청 고생했는데, 알고 보니 Unity 패키지만 업데이트하면 되는 거였어요 완전 허무 ㅋㅋㅋ

마무리

Unity VSCode 연결 문제로 고생하시는 분들 많을 것 같아서 요렇게 정리해봤어요. 저처럼 삼일 동안 헤매지 마시고, 요 글 보고 바로 해결하셨으면 좋겠네요!

혹시 이 방법들로도 Unity VSCode 연결이 안 된다면 댓글로 알려주세요~ 같이 고민해볼게요 ㅎㅎ

그럼 모두 즐거운 Unity 개발 되세요!!

 

 

해시태그

#Unity #VSCode #VisualStudioCode #유니티 #코드에디터 #Unity개발 #UnityVSCode연결 #UnityIDE #유니티VSCode #PackageManager #VisualStudioEditor #Unity초보 #Unity에러 #Unity문제해결 #VSCode설정 #Unity설정 #코드색깔 #IntelliSense #자동완성 #Unity익스텐션 #CSharp #C샵 #Unity스크립트 #Unity코딩 #게임개발 #GameDev #UnityTips #Unity팁 #개발환경설정 #IDE설정 #Unity2021 #Unity2022 #Unity2023 #프로그래밍 #코딩 #개발 #UnityEditor #ExternalTools #csproj #프로젝트파일 #Unity강좌 #Unity튜토리얼