Visual Studio Code 다운로드 및 한글 설정 방법

Visual Studio Code 다운로드 및 한글 설정 방법

Visual Studio Code는 Microsoft에서 개발하는 무료 코드 편집기입니다.

HTML, CSS, JavaScript, Python, PHP, Java, C·C++, JSON과 Markdown 등 다양한 파일을 편집할 수 있으며 자동 완성, 디버깅, 터미널, Git 연동과 확장 프로그램을 지원합니다.

프로그램이 비교적 가벼우면서도 개발 프로젝트 관리에 필요한 기능을 확장할 수 있어 웹 개발, 워드프레스 코드 수정, 서버 설정 파일 편집과 프로그래밍 학습에 널리 활용됩니다.

2026년 7월 기준 Visual Studio Code의 최신 안정 버전은 1.128입니다. VS Code는 안정 버전이 자주 업데이트되므로 설치할 때는 공식 다운로드 페이지와 프로그램의 업데이트 확인 기능을 통해 현재 버전을 확인하는 것이 좋습니다.

Visual Studio Code란?

Visual Studio Code는 Windows, macOS와 Linux에서 사용할 수 있는 무료 코드 편집기입니다.

일반 텍스트 파일뿐 아니라 프로그래밍 언어의 문법 강조, 코드 자동 완성, 오류 표시, 프로젝트 폴더 관리와 통합 터미널 기능을 제공합니다. Microsoft 공식 문서에서는 VS Code를 Windows, macOS와 Linux를 지원하는 무료 오픈소스 코드 편집기로 소개합니다.

Visual Studio Code는 다음과 같은 작업에 사용할 수 있습니다.

• HTML·CSS·JavaScript 웹 개발
• Python 프로그램 작성
• PHP와 워드프레스 코드 수정
• Java, C와 C++ 개발
• JSON과 XML 설정 파일 편집
• Markdown 문서 작성
• Git 저장소 관리
• 서버 로그와 설정 파일 확인
• 확장 프로그램을 이용한 개발 환경 구성
• 터미널에서 명령어 실행
• 코드 디버깅
• 원격 서버와 컨테이너 개발

Visual Studio Code와 Visual Studio는 이름이 비슷하지만 서로 다른 프로그램입니다.

Visual Studio Code는 가벼운 코드 편집기이며, Visual Studio는 주로 .NET과 C++ 프로젝트 개발에 사용하는 통합 개발 환경입니다.

Visual Studio Code 주요 기능

다양한 프로그래밍 언어 지원

VS Code는 기본적으로 여러 프로그래밍 언어의 문법 강조와 코드 구조 표시를 지원합니다.

언어별 확장 프로그램을 설치하면 자동 완성, 실행, 디버깅과 오류 검사 기능을 추가할 수 있습니다.

대표적으로 다음 언어에 활용할 수 있습니다.

• HTML
• CSS
• JavaScript
• TypeScript
• Python
• PHP
• Java
• C
• C++
• C#
• Go
• Rust
• SQL
• JSON
• XML
• YAML
• Markdown
• PowerShell
• Shell Script

IntelliSense 자동 완성

IntelliSense는 코드를 입력할 때 변수, 함수, 속성, 매개변수와 문법 후보를 표시하는 기능입니다.

단순한 단어 자동 완성보다 현재 코드와 설치된 언어 확장을 분석해 관련성이 높은 항목을 보여줍니다.

언어에 따라 별도의 확장 프로그램과 실행 환경이 필요할 수 있습니다.

확장 프로그램

VS Code의 가장 큰 장점 중 하나는 Marketplace에서 필요한 기능을 추가할 수 있다는 점입니다.

왼쪽의 확장 프로그램 메뉴에서 원하는 확장을 검색하고 설치·비활성화·제거할 수 있습니다. Microsoft 공식 문서에서도 Extension Marketplace를 통해 확장을 검색하고 관리하도록 안내합니다.

대표적인 확장 기능은 다음과 같습니다.

• 언어 지원
• 코드 포맷터
• 맞춤법 검사
• Git 기능 강화
• 원격 서버 연결
• Docker와 컨테이너 개발
• 데이터베이스 연결
• Markdown 미리보기
• 테마와 아이콘 변경
• 코드 검사와 오류 분석

통합 터미널

VS Code 화면 안에서 명령 프롬프트, PowerShell, Git Bash와 Linux 셸을 실행할 수 있습니다.

코드를 편집하다가 별도의 터미널 창으로 이동하지 않고 다음과 같은 명령을 실행할 수 있습니다.

• Git 명령
• npm과 Node.js 명령
• Python 실행
• PHP 명령
• 서버 실행
• 패키지 설치
• 빌드와 테스트

Git 연동

Git이 설치돼 있다면 VS Code에서 변경 파일, 커밋, 브랜치와 저장소 상태를 확인할 수 있습니다.

소스 제어 메뉴에서 변경 내용을 비교하고 커밋할 수 있으며 추가 확장을 설치하면 GitHub와 다른 저장소 기능을 강화할 수 있습니다.

디버깅

코드에 중단점을 설정하고 변수 값과 호출 흐름을 확인할 수 있습니다.

언어별 디버거 확장이 필요할 수 있으며, Python이나 C++처럼 실행 환경이 별도로 필요한 언어는 인터프리터 또는 컴파일러도 설치해야 합니다.

설정 동기화

Microsoft 또는 GitHub 계정으로 로그인하면 다음 항목을 여러 PC에서 동기화할 수 있습니다.

• 사용자 설정
• 확장 프로그램
• 키보드 단축키
• 사용자 코드 조각
• UI 상태
• 프로필

공용 컴퓨터에서는 계정 동기화를 사용한 뒤 반드시 로그아웃해야 합니다.

Visual Studio Code와 Notepad++ 차이

구분	Visual Studio Code	Notepad++
주요 용도	프로젝트 개발	빠른 텍스트·코드 수정
지원 운영체제	Windows·Mac·Linux	Windows
실행 속도	비교적 빠름	매우 빠름
통합 터미널	지원	기본 미지원
Git 연동	기본 지원	제한적
디버깅	확장으로 지원	제한적
자동 완성	강력함	기본 기능 중심
확장 프로그램	매우 다양함	플러그인 지원
프로젝트 폴더	편리함	상대적으로 단순
대용량 로그 확인	파일에 따라 무거움	비교적 편리함

파일 한두 개를 빠르게 수정하거나 대용량 로그를 열 때는 Notepad++가 편리합니다.

프로젝트 폴더, Git, 터미널과 디버깅을 함께 사용해야 한다면 Visual Studio Code가 적합합니다.

Visual Studio Code와 Visual Studio 차이

구분	Visual Studio Code	Visual Studio
프로그램 종류	코드 편집기	통합 개발 환경
설치 용량	비교적 작음	큼
실행 속도	빠른 편	상대적으로 무거움
운영체제	Windows·Mac·Linux	Windows 중심
확장 프로그램	Marketplace	워크로드·확장
웹 개발	적합	가능
.NET 개발	확장 필요	강력한 기본 지원
C++ 개발	컴파일러 설정 필요	도구 포함 가능
초보자 접근성	비교적 쉬움	프로젝트에 따라 복잡함

웹 개발, Python과 간단한 코드 편집은 VS Code가 편리합니다.

Windows용 .NET 데스크톱 프로그램이나 대규모 C++ 프로젝트를 개발한다면 Visual Studio가 더 적합할 수 있습니다.

Visual Studio Code 공식 다운로드 방법

Visual Studio Code는 반드시 Microsoft 공식 홈페이지에서 내려받는 것이 좋습니다.

비공식 다운로드 사이트에서는 오래된 버전이나 별도의 설치 관리자를 제공할 수 있습니다.

공식 다운로드 페이지에서는 Windows, macOS와 Linux용 파일을 무료로 제공합니다.

공식 다운로드 페이지 찾기

검색창에 다음과 같이 입력합니다.

Visual Studio Code 공식 다운로드

검색 결과에서 주소가 다음과 같은지 확인하세요.

code.visualstudio.com

공식 페이지의 Download for Windows 버튼을 누르면 일반적인 Windows용 설치 파일을 받을 수 있습니다.

Windows 설치 파일 종류

Windows 다운로드 페이지에는 설치 방식과 프로세서에 따라 여러 파일이 표시될 수 있습니다.

User Installer

현재 Windows 사용자 계정에 VS Code를 설치합니다.

관리자 권한 없이 설치할 수 있는 경우가 많고 업데이트가 편리해 일반 사용자에게 권장됩니다.

Microsoft의 시작 안내에서도 Windows에서는 User Setup 설치 파일을 내려받아 실행하는 방식을 기본 절차로 설명합니다.

System Installer

컴퓨터의 모든 사용자 계정에서 VS Code를 사용할 수 있도록 설치합니다.

일반적으로 관리자 권한이 필요하며 회사나 여러 사람이 함께 사용하는 PC에서 사용할 수 있습니다.

ZIP 버전

설치 프로그램을 실행하지 않고 압축을 풀어 사용할 수 있습니다.

공식 Windows 설치 안내에 따르면 ZIP 파일을 내려받아 압축을 풀고 실행할 수 있지만, ZIP 방식은 새 버전이 나올 때 수동으로 업데이트해야 합니다.

x64와 ARM64

대부분의 Intel·AMD 기반 Windows PC는 x64 버전을 사용합니다.

Qualcomm Snapdragon 기반 Windows PC는 ARM64 버전을 사용할 수 있습니다.

Windows 시스템 종류 확인 방법

다음 경로로 이동합니다.

설정 → 시스템 → 정보 → 시스템 종류

다음 중 하나로 표시됩니다.

• 64비트 운영체제, x64 기반 프로세서
• ARM 기반 프로세서
• 32비트 운영체제, x86 기반 프로세서

현재 VS Code의 최신 Windows 안정 버전은 일반적으로 64비트 Windows 환경을 기준으로 제공됩니다.

오래된 32비트 Windows를 사용하는 경우 최신 버전을 설치하지 못할 수 있습니다.

Visual Studio Code Windows 설치 방법

1. 설치 파일 실행하기

다운로드 폴더에서 VS Code 설치 파일을 더블 클릭합니다.

Windows 사용자 계정 컨트롤이나 보안 경고가 나타나면 파일 이름과 게시자가 Microsoft인지 확인한 뒤 실행합니다.

2. 사용권 계약 확인하기

라이선스 내용을 확인하고 동의 항목을 선택한 뒤 다음으로 이동합니다.

3. 설치 위치 선택하기

User Installer는 일반적으로 현재 사용자 계정의 프로그램 폴더에 설치됩니다.

특별한 이유가 없다면 기본 설치 위치를 그대로 사용하면 됩니다.

4. 시작 메뉴 폴더 선택하기

시작 메뉴에 표시할 폴더를 확인합니다.

기본값을 유지해도 됩니다.

5. 추가 작업 선택하기

설치 과정에서 다음과 같은 옵션이 표시될 수 있습니다.

• 바탕화면 바로가기 만들기
• Windows 탐색기 파일 메뉴에 Code로 열기 추가
• Windows 탐색기 폴더 메뉴에 Code로 열기 추가
• 지원되는 파일 형식의 편집기로 등록
• PATH에 추가

개발용으로 사용할 예정이라면 다음 항목을 활성화하는 것이 좋습니다.

• 파일에서 Code로 열기
• 폴더에서 Code로 열기
• PATH에 추가

PATH에 추가하면 명령 프롬프트나 터미널에서 다음 명령으로 현재 폴더를 VS Code에서 열 수 있습니다.

code .

공식 시작 안내에서도 Windows 설치 프로그램이 code 명령을 PATH에 추가한다고 설명합니다.

6. 설치 진행하기

설정 내용을 확인한 뒤 설치를 누릅니다.

설치가 완료되면 Visual Studio Code 실행을 선택하고 마침을 누릅니다.

macOS 설치 방법

1. VS Code 공식 다운로드 페이지에서 macOS 버전을 선택합니다.
2. DMG 파일을 다운로드합니다.
3. 다운로드한 파일을 엽니다.
4. Visual Studio Code 아이콘을 Applications 폴더로 이동합니다.
5. 응용 프로그램 폴더에서 VS Code를 실행합니다.

공식 설치 안내도 DMG 파일을 열어 Visual Studio Code 앱을 Applications 폴더로 옮기는 방식으로 설명합니다.

Apple Silicon과 Intel Mac에 맞는 설치 파일이 별도로 표시될 수 있으며, Universal 버전이 제공되면 두 환경에서 사용할 수 있습니다.

Linux 설치 방법

Linux는 배포판에 따라 설치 파일을 선택합니다.

대표적인 형식은 다음과 같습니다.

• Ubuntu·Debian: DEB
• Fedora·RHEL 계열: RPM
• Snap
• TAR.GZ

공식 다운로드 페이지에서 운영체제에 맞는 패키지를 선택해 설치하세요.

Visual Studio Code 한글 설정 방법

VS Code는 기본 설치 후 영어로 표시될 수 있습니다.

한글 인터페이스를 사용하려면 Microsoft에서 제공하는 한국어 언어팩을 설치하면 됩니다.

1. 확장 프로그램 메뉴 열기

VS Code 왼쪽의 블록 모양 확장 아이콘을 누릅니다.

단축키는 다음과 같습니다.

Ctrl + Shift + X

2. 한국어 언어팩 검색하기

검색창에 다음 문구를 입력합니다.

Korean Language Pack

검색 결과에서 Microsoft가 제공하는 한국어 언어팩을 선택합니다.

확장 게시자가 Microsoft인지 확인하세요.

3. 언어팩 설치하기

Install 버튼을 누릅니다.

설치가 끝나면 화면 오른쪽 아래에 언어 변경 또는 다시 시작 안내가 나타날 수 있습니다.

4. 표시 언어 변경하기

언어팩 설치 후 다음 단축키를 누릅니다.

Ctrl + Shift + P

명령 팔레트에 다음 문구를 입력합니다.

Configure Display Language

목록에서 한국어를 선택합니다.

5. VS Code 다시 시작하기

프로그램을 다시 시작하면 메뉴와 설정 화면이 한글로 표시됩니다.

Microsoft 공식 문서에서도 언어팩을 설치한 뒤 Configure Display Language 명령으로 표시 언어를 변경하도록 안내합니다.

한글 언어팩이 검색되지 않을 때

다음 항목을 확인하세요.

1. 인터넷 연결 상태를 확인합니다.
2. 확장 검색창의 철자를 확인합니다.
3. VS Code를 최신 버전으로 업데이트합니다.
4. 회사나 학교 네트워크에서 Marketplace가 차단됐는지 확인합니다.
5. 프록시와 방화벽 설정을 확인합니다.
6. 확장 게시자가 Microsoft인지 확인합니다.
7. 프로그램을 다시 시작합니다.

회사나 공공기관 PC에서는 보안 정책으로 확장 설치가 제한될 수 있습니다.

영어로 다시 변경하는 방법

1. Ctrl + Shift + P를 누릅니다.
2. 표시 언어 구성 또는 Configure Display Language를 검색합니다.
3. English를 선택합니다.
4. VS Code를 다시 시작합니다.

한국어 언어팩을 삭제하지 않아도 표시 언어만 영어로 변경할 수 있습니다.

Visual Studio Code 기본 화면 구성

VS Code를 처음 실행하면 여러 영역이 표시됩니다.

활동 표시줄

화면 왼쪽 가장자리의 아이콘 영역입니다.

대표적인 메뉴는 다음과 같습니다.

• 탐색기
• 검색
• 소스 제어
• 실행 및 디버그
• 확장
• 계정
• 설정

사이드바

선택한 활동 표시줄 메뉴의 세부 내용이 표시됩니다.

탐색기를 선택하면 프로젝트의 폴더와 파일 목록을 확인할 수 있습니다.

편집기

코드와 문서를 실제로 작성하는 중앙 영역입니다.

여러 파일을 탭으로 열 수 있고 화면을 좌우나 위아래로 나눠 비교할 수 있습니다.

패널

화면 아래에 다음 기능이 표시됩니다.

• 문제
• 출력
• 디버그 콘솔
• 터미널
• 포트

상태 표시줄

화면 아래쪽에서 현재 파일의 정보를 확인할 수 있습니다.

대표적인 정보는 다음과 같습니다.

• 현재 줄과 열
• 공백 크기
• 문자 인코딩
• 줄바꿈 형식
• 프로그래밍 언어
• Git 브랜치
• 오류와 경고 개수

폴더 열기와 프로젝트 시작 방법

VS Code는 파일 하나만 열 수도 있지만 프로젝트 폴더 전체를 여는 방식이 편리합니다.

폴더 열기

1. 파일 → 폴더 열기를 선택합니다.
2. 작업할 프로젝트 폴더를 선택합니다.
3. 폴더 선택을 누릅니다.
4. 왼쪽 탐색기에서 파일 목록을 확인합니다.

처음 여는 폴더에서는 작업 영역 신뢰 여부를 묻는 화면이 나타날 수 있습니다.

출처를 알 수 없는 프로젝트는 신뢰하지 않고 제한 모드로 여는 것이 안전합니다.

새 파일 만들기

탐색기 상단의 새 파일 아이콘을 누르고 확장자를 포함한 이름을 입력합니다.

예시는 다음과 같습니다.

index.html
style.css
script.js
app.py
functions.php

확장자를 올바르게 지정하면 VS Code가 해당 언어를 자동으로 인식합니다.

개발자 필수 설정 1: 글꼴과 글자 크기

코드를 오래 볼 때는 고정폭 글꼴을 사용하는 것이 좋습니다.

추천 글꼴은 다음과 같습니다.

• D2Coding
• JetBrains Mono
• Cascadia Code
• Consolas
• Source Code Pro
• Noto Sans Mono CJK KR

설정 방법은 다음과 같습니다.

1. 파일 → 기본 설정 → 설정을 엽니다.
2. 검색창에 font family를 입력합니다.
3. Editor: Font Family에 원하는 글꼴을 입력합니다.
4. font size를 검색합니다.
5. 글자 크기를 조절합니다.

일반적으로 13~16 정도부터 시작하면 무난합니다.

개발자 필수 설정 2: 자동 저장

파일을 자주 저장하는 것을 잊는다면 자동 저장 기능을 사용할 수 있습니다.

1. 파일 → 자동 저장을 선택합니다.
2. 또는 설정에서 Auto Save를 검색합니다.
3. 저장 방식을 선택합니다.

대표적인 방식은 다음과 같습니다.

• off: 자동 저장 사용 안 함
• afterDelay: 일정 시간 후 자동 저장
• onFocusChange: 다른 창으로 이동할 때 저장
• onWindowChange: 다른 프로그램으로 이동할 때 저장

자동 저장은 편리하지만 실행 중인 개발 서버가 파일 변경 때마다 다시 시작될 수 있으므로 프로젝트 특성에 맞게 사용하세요.

개발자 필수 설정 3: 탭 크기와 공백 설정

언어마다 권장 들여쓰기가 다를 수 있습니다.

일반적인 예시는 다음과 같습니다.

언어·파일	권장 설정
Python	공백 4칸
Java	공백 4칸
C·C++	프로젝트 규칙
JavaScript	공백 2칸 또는 4칸
HTML·CSS	공백 2칸
JSON	공백 2칸
YAML	공백 2칸

상태 표시줄의 공백: 4 또는 탭 크기 항목을 누르면 현재 파일의 설정을 변경할 수 있습니다.

프로젝트에 .editorconfig 파일이 있다면 해당 프로젝트의 규칙을 우선 적용하세요.

개발자 필수 설정 4: 공백 문자 표시

Python, YAML과 설정 파일에서는 공백과 탭이 섞이면 오류가 발생할 수 있습니다.

1. 설정을 엽니다.
2. Render Whitespace를 검색합니다.
3. 표시 방식을 선택합니다.

다음과 같은 값을 사용할 수 있습니다.

• none
• boundary
• selection
• trailing
• all

항상 모든 공백을 표시하면 화면이 복잡할 수 있으므로 boundary 또는 selection부터 사용해 보세요.

개발자 필수 설정 5: 미니맵 끄기 또는 켜기

편집기 오른쪽의 작은 코드 미리보기를 미니맵이라고 합니다.

긴 파일의 전체 구조를 빠르게 확인할 수 있지만 작은 화면에서는 편집 공간을 차지할 수 있습니다.

설정에서 Minimap Enabled를 검색해 켜거나 끌 수 있습니다.

개발자 필수 설정 6: 줄 바꿈 설정

긴 문장이 화면 밖으로 넘어갈 때 자동 줄 바꿈을 사용할 수 있습니다.

단축키는 다음과 같습니다.

Alt + Z

Markdown, 텍스트와 로그 파일을 볼 때 편리합니다.

코드 파일에서는 줄 구조가 달라 보일 수 있으므로 필요할 때만 사용하는 것이 좋습니다.

개발자 필수 설정 7: 기본 문자 인코딩 확인

VS Code는 일반적으로 UTF-8을 기본으로 사용합니다.

현재 파일의 문자 인코딩은 상태 표시줄의 UTF-8 항목에서 확인할 수 있습니다.

한글이 깨진다면 다음 순서로 확인하세요.

1. 상태 표시줄의 인코딩을 누릅니다.
2. 인코딩하여 다시 열기를 선택합니다.
3. UTF-8, EUC-KR 또는 Korean 계열 인코딩을 확인합니다.
4. 글자가 정상적으로 보이는 인코딩을 찾습니다.
5. 필요하면 인코딩하여 저장에서 UTF-8을 선택합니다.

깨진 상태에서 파일을 저장하면 원래 한글을 복구하기 어려울 수 있으므로 먼저 복사본을 만드세요.

개발자 필수 설정 8: 줄바꿈 형식

상태 표시줄의 CRLF 또는 LF를 누르면 줄바꿈 형식을 변경할 수 있습니다.

• Windows: CRLF
• Linux·macOS: LF

웹 서버, Git 프로젝트와 셸 스크립트는 LF를 사용하는 경우가 많습니다.

프로젝트 규칙을 확인한 뒤 설정하세요.

개발자 필수 설정 9: Format on Save

파일을 저장할 때 자동으로 코드 형식을 정리하려면 Format on Save를 사용할 수 있습니다.

1. 설정을 엽니다.
2. Format On Save를 검색합니다.
3. 기능을 활성화합니다.
4. 언어에 맞는 포맷터 확장을 설치합니다.
5. 기본 포맷터를 지정합니다.

포맷터가 여러 개 설치돼 있다면 저장할 때 충돌하거나 예상하지 않은 형식으로 코드가 변경될 수 있습니다.

팀 프로젝트에서는 사용하는 포맷터와 설정을 먼저 확인하세요.

개발자 필수 설정 10: 설정 동기화

여러 컴퓨터에서 같은 환경을 사용하려면 설정 동기화를 활성화할 수 있습니다.

1. 왼쪽 아래 계정 아이콘을 누릅니다.
2. 설정 동기화 켜기를 선택합니다.
3. Microsoft 또는 GitHub 계정으로 로그인합니다.
4. 동기화할 항목을 선택합니다.

공용 컴퓨터에서는 사용 후 반드시 동기화를 끄고 계정에서 로그아웃하세요.

확장 프로그램 설치 방법

1. 왼쪽의 확장 아이콘을 누릅니다.
2. 검색창에 확장 이름을 입력합니다.
3. 게시자와 다운로드 정보를 확인합니다.
4. 설치를 누릅니다.
5. 필요한 경우 VS Code를 다시 시작합니다.

확장을 무조건 많이 설치하면 프로그램 시작 속도와 메모리 사용량이 증가하고 충돌 가능성도 높아질 수 있습니다.

필요한 확장만 설치하는 것이 좋습니다.

초보자에게 유용한 확장 프로그램

Korean Language Pack

VS Code 메뉴를 한글로 변경합니다.

게시자가 Microsoft인지 확인하세요.

Prettier

HTML, CSS, JavaScript, JSON과 Markdown 등의 코드 형식을 정리할 때 많이 사용됩니다.

프로젝트에 기존 포맷 규칙이 있다면 Prettier 설정을 먼저 확인하세요.

ESLint

JavaScript와 TypeScript 코드의 오류와 스타일 문제를 검사합니다.

실제 동작을 위해 프로젝트에 ESLint 패키지와 설정 파일이 필요할 수 있습니다.

Live Server

HTML 파일을 로컬 웹서버에서 실행하고 저장할 때 브라우저를 자동 새로고침할 수 있습니다.

단순 HTML·CSS 학습과 정적 웹페이지 확인에 편리합니다.

Python

Microsoft에서 제공하는 Python 개발 확장입니다.

코드 실행, 자동 완성, 디버깅과 환경 선택 기능을 제공합니다.

Python 프로그램 자체는 별도로 설치해야 합니다.

C/C++

Microsoft의 C와 C++ 개발 확장입니다.

문법 지원, IntelliSense와 디버깅 기능을 제공하지만 코드를 컴파일하려면 GCC, Clang 또는 MSVC 같은 컴파일러가 별도로 필요합니다.

PHP Intelephense

PHP 코드 자동 완성, 함수 탐색과 오류 분석에 활용됩니다.

워드프레스 테마나 플러그인 코드를 편집할 때 유용합니다.

GitLens

Git 커밋 기록, 줄별 변경 이력과 브랜치 정보를 자세하게 확인할 수 있습니다.

Remote – SSH

SSH를 통해 원격 Linux 서버의 폴더를 VS Code에서 열어 작업할 수 있습니다.

운영 서버 파일을 직접 수정하면 장애가 발생할 수 있으므로 백업과 테스트 환경을 먼저 준비하세요.

Markdown All in One

Markdown 문서 작성, 목차와 단축키 기능을 강화합니다.

통합 터미널 사용 방법

다음 메뉴를 선택합니다.

터미널 → 새 터미널

단축키는 일반적으로 다음과 같습니다.

Ctrl + `

터미널에서 현재 프로젝트 폴더를 기준으로 명령을 실행할 수 있습니다.

예시는 다음과 같습니다.

python app.py

npm install

git status

php -S localhost:8000

명령이 작동하려면 Python, Node.js, Git 또는 PHP가 Windows에 설치돼 있고 PATH가 설정돼 있어야 합니다.

코드 실행 버튼이 작동하지 않을 때

VS Code 자체는 모든 프로그래밍 언어의 실행 환경을 포함하지 않습니다.

예를 들어 Python 코드를 실행하려면 다음 항목이 필요합니다.

• Python 설치
• Python 확장 설치
• 올바른 인터프리터 선택
• .py 파일 저장

C와 C++은 다음 항목이 필요합니다.

• C·C++ 확장
• GCC, Clang 또는 Visual Studio Build Tools
• 컴파일과 디버깅 설정

언어 확장만 설치했다고 컴파일러나 인터프리터가 자동으로 설치되는 것은 아닙니다.

Python 개발 환경 설정 예시

1. Python 공식 설치 파일을 설치합니다.
2. 설치 중 PATH 추가 옵션을 확인합니다.
3. VS Code에서 Python 확장을 설치합니다.
4. Python 파일을 엽니다.
5. Ctrl + Shift + P를 누릅니다.
6. Python: Select Interpreter를 실행합니다.
7. 사용할 Python 환경을 선택합니다.
8. 터미널에서 다음 명령으로 버전을 확인합니다.

python --version

가상 환경을 사용하는 프로젝트라면 프로젝트별 인터프리터를 선택하세요.

HTML 파일 미리보기 방법

HTML 파일을 브라우저에서 확인하는 가장 간단한 방법은 파일을 저장한 뒤 브라우저에서 여는 것입니다.

Live Server 확장을 설치했다면 다음과 같이 사용할 수 있습니다.

1. HTML 파일을 엽니다.
2. 파일을 저장합니다.
3. 오른쪽 아래의 Go Live를 누릅니다.
4. 브라우저에서 결과를 확인합니다.

최신 VS Code에는 로컬 HTML 파일을 통합 브라우저에서 미리 보는 기능도 계속 개선되고 있습니다.

워드프레스 개발에 유용한 설정

VS Code는 워드프레스 테마, 플러그인과 CSS 파일을 편집할 때 활용할 수 있습니다.

PHP 확장 설치

PHP Intelephense와 같은 확장을 설치하면 함수 자동 완성과 코드 탐색이 편리해집니다.

WordPress 함수 자동 완성

워드프레스 함수 정의를 지원하는 스니펫 또는 자동 완성 확장을 사용할 수 있습니다.

확장 게시자와 업데이트 상태를 확인하세요.

UTF-8 저장

PHP, CSS와 JavaScript 파일은 일반적으로 UTF-8로 저장합니다.

PHP 파일에서는 BOM이 예기치 않은 출력이나 헤더 오류를 일으킬 수 있으므로 UTF-8 BOM 여부를 확인하는 것이 좋습니다.

수정 전 백업

다음 파일을 수정하기 전에는 반드시 복사본을 보관하세요.

• wp-config.php
• .htaccess
• functions.php
• 테마 CSS
• 플러그인 PHP 파일

운영 서버 직접 수정 주의

Remote SSH 또는 FTP 확장으로 운영 서버 파일을 바로 편집할 수 있지만 잘못 저장하면 사이트 전체에 오류가 발생할 수 있습니다.

가능하면 로컬 또는 스테이징 환경에서 먼저 테스트하세요.

Visual Studio Code 단축키

기능	Windows 단축키
명령 팔레트	Ctrl + Shift + P
빠른 파일 열기	Ctrl + P
설정 열기	Ctrl + ,
확장 열기	Ctrl + Shift + X
새 파일	Ctrl + N
파일 열기	Ctrl + O
저장	Ctrl + S
모두 저장	Ctrl + K, S
탭 닫기	Ctrl + W
찾기	Ctrl + F
바꾸기	Ctrl + H
전체 검색	Ctrl + Shift + F
줄로 이동	Ctrl + G
터미널 열기	Ctrl + `
주석 전환	Ctrl + /
코드 정리	Shift + Alt + F
줄 복사	Shift + Alt + ↓
줄 이동	Alt + ↑ 또는 ↓
다음 탭	Ctrl + Page Down
이전 탭	Ctrl + Page Up
사이드바 숨기기	Ctrl + B
줄 바꿈	Alt + Z
정의로 이동	F12
이름 변경	F2
자동 완성	Ctrl + Space

단축키는 운영체제, 키보드 배열과 사용자 설정에 따라 달라질 수 있습니다.

VS Code 업데이트 방법

VS Code 안정 버전은 자동 업데이트를 지원합니다.

즉시 확인하려면 다음 메뉴를 사용합니다.

도움말 → 업데이트 확인

최근 버전은 사용자에게 단계적으로 배포될 수 있으며, 공식 릴리스 안내에서도 바로 업데이트하려면 프로그램의 Check for Updates 기능을 사용하도록 설명합니다.

Stable과 Insiders 차이

• Stable: 일반 사용자용 안정 버전
• Insiders: 새로운 기능이 매일 제공되는 시험 버전

Insiders는 Stable과 함께 설치해 사용할 수 있지만 기능이 불안정하거나 오류가 발생할 수 있습니다. 공식 안내에서도 Insiders 빌드는 매일 업데이트되며 가끔 문제가 발생할 수 있다고 설명합니다.

일반 사용자는 Stable 버전을 권장합니다.

Visual Studio Code 자주 발생하는 오류 해결

VS Code가 실행되지 않는 경우

다음 방법을 순서대로 확인하세요.

1. PC를 다시 시작합니다.
2. VS Code를 관리자 권한으로 실행합니다.
3. 최신 버전을 다시 설치합니다.
4. 최근 설치한 확장을 비활성화합니다.
5. GPU 가속 없이 실행해 봅니다.
6. 사용자 설정을 백업한 뒤 초기화합니다.
7. 백신이나 보안 프로그램의 차단 기록을 확인합니다.

한글 메뉴가 적용되지 않는 경우

1. Microsoft 한국어 언어팩이 설치됐는지 확인합니다.
2. Ctrl + Shift + P를 누릅니다.
3. Configure Display Language를 실행합니다.
4. 한국어를 선택합니다.
5. VS Code를 완전히 종료합니다.
6. 다시 실행합니다.

언어팩을 설치한 것만으로 자동 적용되지 않는 경우 표시 언어를 직접 선택해야 합니다.

확장 프로그램이 설치되지 않는 경우

• 인터넷 연결을 확인합니다.
• VS Code를 최신 버전으로 업데이트합니다.
• 회사나 학교 방화벽을 확인합니다.
• 프록시 설정을 확인합니다.
• 확장 게시자를 확인합니다.
• 사용자 폴더 쓰기 권한을 확인합니다.
• VS Code를 다시 시작합니다.

기업 환경에서는 관리 정책으로 확장 설치가 차단될 수 있습니다.

코드 자동 완성이 작동하지 않는 경우

• 파일 확장자를 확인합니다.
• 오른쪽 아래의 언어 모드를 확인합니다.
• 해당 언어 확장을 설치합니다.
• 프로젝트 폴더 전체를 열어봅니다.
• 인터프리터 또는 SDK를 선택합니다.
• 확장 프로그램을 다시 시작합니다.
• Ctrl + Space로 자동 완성을 호출합니다.

터미널에서 명령을 찾을 수 없는 경우

예를 들어 다음과 같은 메시지가 나타날 수 있습니다.

'python'은 내부 또는 외부 명령이 아닙니다.

주요 원인은 다음과 같습니다.

• 프로그램이 설치되지 않음
• PATH 설정이 되지 않음
• 설치 후 터미널을 다시 열지 않음
• 명령 이름이 다름
• 가상 환경이 활성화되지 않음

Python, Node.js, Git과 컴파일러는 각각 별도로 설치해야 합니다.

code 명령이 작동하지 않는 경우

설치 과정에서 PATH 추가가 선택되지 않았을 수 있습니다.

다음 방법을 확인하세요.

1. 명령 프롬프트와 VS Code를 모두 종료합니다.
2. Windows를 다시 로그인하거나 재부팅합니다.
3. VS Code 설치 프로그램을 다시 실행합니다.
4. PATH에 추가 옵션을 확인합니다.
5. User Installer 또는 System Installer를 다시 설치합니다.

한글 파일이 깨지는 경우

1. 상태 표시줄의 UTF-8 항목을 누릅니다.
2. 인코딩하여 다시 열기를 선택합니다.
3. 원래 파일 인코딩을 선택합니다.
4. 정상적으로 표시되는지 확인합니다.
5. 필요하면 UTF-8로 다시 저장합니다.

깨진 상태에서 바로 저장하지 마세요.

코드 포맷이 저장할 때마다 바뀌는 경우

• Format on Save 설정을 확인합니다.
• 기본 포맷터를 확인합니다.
• Prettier와 ESLint 충돌 여부를 확인합니다.
• 프로젝트의 .vscode/settings.json을 확인합니다.
• .prettierrc와 ESLint 설정을 확인합니다.
• 사용하지 않는 포맷터를 비활성화합니다.

프로젝트 설정은 사용자 설정보다 우선 적용될 수 있습니다. VS Code는 전체 사용자 설정과 프로젝트별 작업 영역 설정을 구분해 관리합니다.

프로그램이 느려지는 경우

• 사용하지 않는 확장을 비활성화합니다.
• 큰 폴더를 검색 제외 목록에 추가합니다.
• node_modules와 빌드 폴더를 감시 대상에서 제외합니다.
• 열려 있는 대용량 파일을 닫습니다.
• 불필요한 터미널과 탭을 정리합니다.
• 확장 실행 상태를 확인합니다.
• 최신 버전으로 업데이트합니다.

CPU와 메모리 사용량이 높은 경우

다음 항목을 확인하세요.

• 파일 감시 대상이 지나치게 큰지 확인
• 대규모 Git 저장소인지 확인
• 언어 서버가 반복 실행되는지 확인
• 확장 프로그램 충돌 확인
• 검색 제외 설정 확인
• 프로젝트의 생성 파일 폴더 제외
• 확장 호스트 재시작

폴더를 열었는데 제한 모드가 표시되는 경우

VS Code의 Workspace Trust 기능이 작동한 것입니다.

출처를 모르는 프로젝트는 확장 실행과 작업 기능이 제한될 수 있습니다.

본인이 만들었거나 신뢰할 수 있는 폴더인지 확인한 뒤 신뢰 여부를 결정하세요.

최신 릴리스에서도 알 수 없는 코드를 안전하게 확인할 수 있도록 작업 영역 신뢰와 제한 모드 기능이 강화되고 있습니다.

설정이 저장되지 않는 경우

• 설정 파일에 JSON 문법 오류가 있는지 확인합니다.
• 사용자 폴더 권한을 확인합니다.
• 회사 정책으로 설정이 고정됐는지 확인합니다.
• 작업 영역 설정이 사용자 설정을 덮어쓰는지 확인합니다.
• 설정 동기화 충돌 여부를 확인합니다.

VS Code 설정은 설정 화면이나 settings.json에서 변경할 수 있으며 사용자 설정과 작업 영역 설정이 따로 적용됩니다.

포터블 버전 사용 방법

Windows ZIP 버전을 압축 해제한 뒤 실행하면 설치 없이 사용할 수 있습니다.

설정과 확장을 실행 폴더 안에 함께 저장하려면 공식 포터블 모드를 구성할 수 있습니다.

Windows와 Linux에서는 새 버전으로 업데이트할 때 기존 data 폴더를 새 버전 폴더로 복사해 설정을 유지할 수 있습니다.

포터블 버전은 USB에서 사용할 수 있지만 다음 제한이 있습니다.

• 자동 업데이트가 제한될 수 있음
• PATH 등록을 직접 해야 함
• 파일 연결이 자동으로 적용되지 않음
• 읽기 전용 저장장치에서는 설정 저장 불가
• 확장과 캐시로 용량이 커질 수 있음

Visual Studio Code 삭제 방법

1. Windows 설정 → 앱 → 설치된 앱으로 이동합니다.
2. Visual Studio Code를 검색합니다.
3. 오른쪽 메뉴 버튼을 누릅니다.
4. 제거를 선택합니다.
5. 화면 안내에 따라 삭제합니다.

프로그램을 제거해도 사용자 설정과 확장 데이터가 남을 수 있습니다.

완전히 초기화하려면 사용자 설정 폴더와 확장 폴더를 별도로 확인해야 하지만, 다시 설치할 예정이라면 먼저 백업하세요.

Visual Studio Code 안전하게 사용하는 방법

공식 홈페이지에서 다운로드하기

설치 파일은 Microsoft 공식 VS Code 사이트에서 내려받으세요.

확장 게시자 확인하기

비슷한 이름의 확장이 여러 개 있을 수 있습니다.

설치 전 다음 항목을 확인하세요.

• 게시자
• 인증 표시
• 업데이트 날짜
• 다운로드 수
• 권한과 기능
• GitHub 또는 공식 문서

확장 프로그램 최소화하기

확장은 VS Code와 프로젝트 파일에 접근할 수 있습니다.

필요하지 않거나 관리가 중단된 확장은 제거하는 것이 좋습니다.

알 수 없는 프로젝트 신뢰하지 않기

인터넷에서 받은 프로젝트에는 자동 실행 작업이나 악성 스크립트가 포함될 수 있습니다.

출처를 확인하기 전에는 제한 모드로 여세요.

중요한 파일 백업하기

전체 검색·바꾸기, 코드 포맷터와 자동 수정은 여러 파일을 한 번에 변경할 수 있습니다.

Git 커밋이나 백업을 만든 뒤 실행하세요.

운영 서버 직접 편집 주의

원격 서버 연결 기능으로 운영 파일을 바로 수정할 수 있지만 실수하면 서비스 장애가 발생할 수 있습니다.

로컬과 스테이징 환경에서 먼저 테스트하세요.

Visual Studio Code FAQ

Visual Studio Code는 무료인가요?

네. Visual Studio Code는 Windows, macOS와 Linux에서 무료로 사용할 수 있는 코드 편집기입니다.

Visual Studio Code는 한글을 지원하나요?

네. Microsoft에서 제공하는 Korean Language Pack을 설치한 뒤 표시 언어를 한국어로 변경할 수 있습니다.

일반 Windows PC는 어떤 버전을 받아야 하나요?

대부분의 Intel 또는 AMD 기반 Windows 10·11 PC에서는 Windows x64 User Installer를 선택하면 됩니다.

Snapdragon 기반 Windows PC는 ARM64 버전을 확인하세요.

설치형과 ZIP 버전 중 무엇이 좋은가요?

한 대의 PC에서 계속 사용할 예정이라면 자동 업데이트와 PATH 설정이 편리한 설치형을 권장합니다.

설치 권한이 없거나 USB에서 사용하려면 ZIP 또는 포터블 방식을 선택할 수 있습니다.

VS Code만 설치하면 Python을 실행할 수 있나요?

아니요.

VS Code는 편집기이므로 Python 프로그램과 Python 확장을 별도로 설치하고 인터프리터를 선택해야 합니다.

C와 C++ 코드를 바로 실행할 수 있나요?

C·C++ 확장뿐 아니라 GCC, Clang 또는 MSVC와 같은 컴파일러가 필요합니다.

Windows에서 GCC를 사용하려면 MinGW 계열 도구를 설정할 수 있으며 Microsoft는 공식 문서에서 MinGW-w64와 GDB 설정 예제를 제공합니다.

Visual Studio Code와 Visual Studio는 같은 프로그램인가요?

아닙니다.

VS Code는 확장 가능한 코드 편집기이고 Visual Studio는 .NET과 C++ 개발 기능이 통합된 대규모 개발 환경입니다.

VS Code에서 HTML을 실행할 수 있나요?

HTML은 컴파일하는 파일이 아니므로 브라우저에서 열어 확인합니다.

Live Server 확장이나 최신 통합 브라우저 미리보기 기능을 사용할 수 있습니다.

VS Code에서 워드프레스 파일을 편집할 수 있나요?

가능합니다.

PHP, CSS, JavaScript와 JSON 파일을 편집할 수 있으며 PHP 자동 완성이나 WordPress 관련 확장을 설치할 수 있습니다.

운영 사이트 파일은 수정 전 반드시 백업하세요.

Mac에서도 한글 설정 방법이 같은가요?

네. 확장 메뉴에서 Korean Language Pack을 설치한 뒤 명령 팔레트의 Configure Display Language에서 한국어를 선택하면 됩니다.

Mac에서는 명령 팔레트 단축키가 Command + Shift + P입니다.

브라우저에서 VS Code를 사용할 수 있나요?

vscode.dev를 이용하면 설치 없이 브라우저에서 VS Code 기반 편집 환경을 사용할 수 있습니다.

다만 로컬 터미널, 일부 확장과 실행 기능은 데스크톱 버전보다 제한됩니다.

마무리

Visual Studio Code는 코드 작성, 프로젝트 관리, Git, 터미널과 디버깅 기능을 확장할 수 있는 실용적인 무료 개발 도구입니다.

처음 설치한 뒤에는 다음 순서로 설정하면 됩니다.

1. VS Code 공식 홈페이지에 접속합니다.
2. 일반적인 Windows PC에서는 x64 User Installer를 다운로드합니다.
3. 설치 과정에서 Code로 열기와 PATH 추가를 선택합니다.
4. 확장 메뉴에서 Microsoft 한국어 언어팩을 설치합니다.
5. Configure Display Language에서 한국어를 선택합니다.
6. 글꼴과 글자 크기를 설정합니다.
7. 탭 크기, 공백과 인코딩을 확인합니다.
8. 필요한 언어 확장만 설치합니다.
9. 통합 터미널과 Git 기능을 설정합니다.
10. 설정 동기화와 자동 업데이트를 활성화합니다.

VS Code만 설치했다고 모든 언어를 바로 실행할 수 있는 것은 아닙니다.

Python, PHP, Java와 C++는 언어별 실행 프로그램, SDK 또는 컴파일러를 별도로 설치해야 하며, 확장 프로그램은 해당 개발 환경과 VS Code를 연결하는 역할을 합니다.

📚 함께 보면 좋은 글

Everything 다운로드 및 설치 방법
https://policyplus.co.kr/windows-program/361/