[Unity] Unity와 Visual Studio Code 연동 가이드

 

정신건강을 위해....visual studio code를 활용합시다...

개발자 정신건강에 이롭습니다...

 

1. Visual Studio Code 설치 및 Unity 연동

1.1 Visual Studio Code 다운로드 및 설치

1. VS Code 공식 웹사이트에 접속하여 설치 파일을 다운로드합니다.
2. 운영체제에 맞는 설치 파일을 실행하여 VS Code를 설치합니다.

Visual Studio Code

---

2. Unity에서 VS Code를 기본 코드 편집기로 설정

2.1 Unity에서 기본 편집기 변경

1. Unity를 실행하고 Edit → Preferences(Mac에서는 Unity → Settings, Preferences)로 이동합니다.
2. External Tools 탭을 선택합니다.
3. External Script Editor 항목을 클릭하고 Visual Studio Code를 선택합니다.
4. 변경 사항이 자동으로 저장됩니다.

 

 

2.2 .csproj 파일 자동 생성 설정

Unity가 VS Code에서 올바르게 작동하려면 .csproj(C# 프로젝트) 파일이 필요합니다. 최신 버전의 Unity에서는 자동 생성되지 않을 수 있으므로, 아래 설정을 활성화합니다.

1. Unity에서 Edit → Preferences로 이동합니다.
2. External Tools 탭에서 Generate .csproj files for: 항목을 확인합니다.
3. Regenerate project files 버튼을 클릭하여 프로젝트 파일을 갱신합니다.

 

---

3. Visual Studio Code - Unity Extention 추천

3.1 C# 확장팩 설치

1. VS Code를 실행합니다.
2. 좌측 사이드바의 Extensions(확장) 아이콘을 클릭합니다.
3. 검색창에 C#을 입력하고 C# for Visual Studio Code (by Microsoft) 확장팩을 설치합니다.
4. 추가적으로 Debugger for Unity 확장도 함께 설치하면 디버깅 환경이 개선됩니다.

3.2 Unity 및 C# 개발을 위한 추천 확장팩

• C# (by Microsoft): Unity 및 일반적인 C# 개발을 위한 필수 확장팩입니다.
• Debugger for Unity: Unity 프로젝트 디버깅을 지원합니다.
• Unity Code Snippets: Unity 관련 코드 스니펫을 제공하여 빠른 코드 작성을 도와줍니다.
• OmniSharp: C# 자동 완성과 코드 분석 기능을 강화해줍니다.
• Shader languages support for VS Code: Unity의 ShaderLab 및 HLSL 코드 작성을 지원합니다.

 

 

---

4. 발생할 수 있는 문제 해결

4.1 C# 코드 자동 완성이 작동하지 않을 때

• Extention이 올바르게 실행되지 않는 경우가 있습니다.
• 해결 방법:
  1. **Command Palette (Ctrl + Shift + P 또는 Cmd + Shift + P)**에서 OmniSharp: Restart OmniSharp을 실행합니다.
  2. .csproj 파일이 손상되었을 수 있으므로 Unity에서 Regenerate project files를 실행합니다.

4.2 Unity에서 VS Code로 코드가 열리지 않는 문제

• External Script Editor 설정이 Visual Studio Code로 되어 있는지 확인합니다.
• 프로젝트 경로에 한글, 공백, 특수 문자가 포함되어 있는 경우 VS Code가 인식하지 못할 수 있습니다.
  • 해결 방법: Unity 프로젝트 폴더명을 영문자로 변경하고 다시 시도합니다.

4.3 디버깅이 정상적으로 동작하지 않을 때

• Unity의 Scripting Backend가 Mono로 설정되어 있는지 확인합니다. (IL2CPP에서는 VS Code 디버깅이 정상적으로 작동하지 않을 수 있음)
• Unity Hub에서 Visual Studio Code Editor 패키지를 설치했는지 확인합니다.