Linux 용 Windows 하위 시스템을 사용 하 여 Visual Studio Code 시작Get started using Visual Studio Code with Windows Subsystem for Linux

원격 WSL 확장과 함께 Visual Studio Code를 사용 하면 VS Code에서 직접 WSL을 전체 시간 개발 환경으로 사용할 수 있습니다.Visual Studio Code, along with the Remote - WSL extension, enables you to use WSL as your full-time development environment directly from VS Code. 다음을 수행할 수 있습니다.You can:

  • Linux 기반 환경에서 개발develop in a Linux-based environment
  • Linux 특정 도구 체인 및 유틸리티 사용use Linux-specific toolchains and utilities
  • Outlook 및 Office와 같은 생산성 도구에 대 한 액세스를 유지 하면서 Windows에서 편안 하 게 Linux 기반 응용 프로그램을 실행 하 고 디버그 합니다.run and debug your Linux-based applications from the comfort of Windows while maintaining access to productivity tools like Outlook and Office
  • VS Code 기본 제공 터미널을 사용 하 여 선택한 Linux 배포를 실행 합니다.use the VS Code built-in terminal to run your Linux distribution of choice
  • Intellisense 코드 완성, lint, 디버그 지원, 코드 조각유닛 테스트 와 같은 VS Code 기능 활용take advantage of VS Code features like Intellisense code completion, linting, debug support, code snippets, and unit testing
  • VS Code의 기본 제공 Git 지원 으로 손쉽게 버전 제어 관리easily manage your version control with VS Code's built-in Git support
  • WSL 프로젝트에서 직접 명령 및 VS Code 확장 실행run commands and VS Code extensions directly on your WSL projects
  • pathing 문제, 이진 호환성 또는 기타 OS 간 문제를 걱정 하지 않고 Linux 또는 탑재 된 Windows 파일 시스템 (예:/mnt/c)에서 파일을 편집 합니다.edit files in your Linux or mounted Windows filesystem (for example /mnt/c) without worrying about pathing issues, binary compatibility, or other cross-OS challenges

VS Code 및 원격 WSL 확장 설치Install VS Code and the Remote WSL extension

  • VS Code 설치 페이지 를 방문 하 여 32 또는 64 비트 설치 관리자를 선택 합니다.Visit the VS Code install page and select the 32 or 64 bit installer. Windows에 Visual Studio Code를 설치 합니다 (WSL 파일 시스템이 아님).Install Visual Studio Code on Windows (not in your WSL file system).

  • 설치 하는 동안 추가 작업을 선택 하 라는 메시지가 표시 되는 경우 코드 명령을 사용 하 여 wsl에서 폴더를 쉽게 열 수 있도록 경로에 추가 옵션을 선택 해야 합니다.When prompted to Select Additional Tasks during installation, be sure to check the Add to PATH option so you can easily open a folder in WSL using the code command.

  • 원격 개발 확장 팩을 설치 합니다.Install the Remote Development extension pack. 이 확장 팩은 원격-SSH 및 원격 컨테이너 확장 외에도 원격-WSL 확장을 포함 하 여 컨테이너, 원격 컴퓨터 또는 WSL의 모든 폴더를 열 수 있도록 합니다.This extension pack includes the Remote - WSL extension, in addition to the Remote - SSH, and Remote - Containers extensions, enabling you to open any folder in a container, on a remote machine, or in WSL.

중요

원격 WSL 확장을 설치 하려면 VS Code의 1.35 버전 이상이 필요 합니다.In order to install the Remote-WSL extension, you will need the 1.35 May release version or later of VS Code. 자동 완성, 디버깅, lint 등에 대 한 지원이 손실 될 것 이므로, 원격-WSL 확장이 없으면 VS Code에서 WSL을 사용 하지 않는 것이 좋습니다. 흥미로운 사실:이 WSL 확장은 $HOME/확장명 (PowerShell에서 명령을 입력)에 설치 됩니다 ls $HOME\.vscode\extensions\ .We do not recommend using WSL in VS Code without the Remote-WSL extension as you will lose support for auto-complete, debugging, linting, etc. Fun fact: this WSL extension is installed in $HOME/.vscode/extensions (enter the command ls $HOME\.vscode\extensions\ in PowerShell).

Linux 배포 업데이트Update your Linux distribution

일부 WSL Linux 배포판에는 VS Code 서버에서 시작 하는 데 필요한 라이브러리가 부족 합니다.Some WSL Linux distributions are lacking libraries that are required by the VS Code server to start up. 패키지 관리자를 사용 하 여 Linux 배포에 라이브러리를 더 추가할 수 있습니다.You can add additional libraries into your Linux distribution by using its package manager.

예를 들어 Debian 또는 Ubuntu를 업데이트 하려면 다음을 사용 합니다.For example, to update Debian or Ubuntu, use:

sudo apt-get update

Wget (웹 서버에서 콘텐츠 검색) 및 ca 인증서 (SSL 기반 응용 프로그램에서 SSL 연결의 신뢰성을 확인할 수 있도록 하려면)를 추가 하려면 다음을 입력 합니다.To add wget (to retrieve content from web servers) and ca-certificates (to allow SSL-based applications to check for the authenticity of SSL connections), enter:

sudo apt-get install wget ca-certificates

Visual Studio Code에서 WSL 프로젝트를 엽니다.Open a WSL project in Visual Studio Code

명령줄에서From the command-line

WSL 배포에서 프로젝트를 열려면 분포의 명령줄을 열고 다음을 입력 합니다. code .To open a project from your WSL distribution, open the distribution's command line and enter: code .

VS Code 원격 서버를 사용 하 여 WSL 프로젝트 열기

VS Code에서From VS Code

바로 가기를 사용 하 여 추가 VS Code 원격 옵션에 액세스할 수도 있습니다. CTRL+SHIFT+P VS Code에서 명령 팔레트를 표시 합니다.You can also access more VS Code Remote options by using the shortcut: CTRL+SHIFT+P in VS Code to bring up the command palette. 그런 다음을 입력 하면 VSCODE-REMOTE 사용 가능한 VS Code 모든 원격 옵션을 볼 수 있습니다 .이 옵션을 사용 하면 원격 세션에서 폴더를 다시 열고에서 열 배포를 지정할 수 있습니다.If you then type VSCODE-REMOTE you will see all of the VS Code Remote options available, allowing you to reopen the folder in a remote session, specify which distribution you want to open in, and more.

VS Code의 명령 팔레트

VS Code 원격 내의 확장Extensions inside of VS Code Remote

원격 WSL 확장은 Windows 컴퓨터에서 실행 되는 클라이언트 (사용자 인터페이스)와 원격으로 실행 되는 서버 (코드, Git, 플러그 인 등)를 사용 하 여 "클라이언트 서버" 아키텍처로 VS Code 분할 합니다.The Remote-WSL extension splits VS Code into a “client-server” architecture, with the client (the user interface) running on your Windows machine and the server (your code, Git, plugins, etc) running remotely.

원격 VS Code를 실행 하는 경우 ' 확장 ' 탭을 선택 하면 로컬 컴퓨터와 WSL 배포 간에 분할 된 확장의 목록이 표시 됩니다.When running VS Code Remote, selecting the 'Extensions' tab will display a list of extensions split between your local machine and your WSL distribution.

테마와 같이 로컬 확장을 설치 하는 경우에는 한 번만 설치 하면 됩니다.Installing a local extension, like a theme, only needs to be installed once.

Python 확장 또는 lint 또는 디버깅과 같은 항목을 처리 하는 것과 같은 일부 확장은 각 원격 wsl 배포에 별도로 설치 되어야 합니다.Some extensions, like the Python extension or anything that handles things like linting or debugging, must be installed separately on each remote WSL distributions. ⚠Wsl 원격에 설치 되지 않은 확장을 로컬로 설치 하는 경우 VS Code에는 녹색 "wsl에 설치" 단추가 표시 됩니다.VS Code will display a warning icon ⚠, along with a green "Install in WSL" button, if you have an extension locally installed that is not installed on your WSL Remote.

원격-WSL 확장 및 로컬 확장을 사용 하 여 VS Code

자세한 내용은 VS Code 문서를 참조 하세요.For further information, see the VS Code docs:

  • WSL에서 원격 VS Code 시작 하면 셸 시작 스크립트가 실행 되지 않습니다.When VS Code Remote is started in WSL, no shell startup scripts are run. 추가 명령을 실행 하거나 환경을 수정 하는 방법에 대 한 자세한 내용은이 고급 환경 설정 스크립트 문서 를 참조 하세요.See this advanced environment setup script article for more info on how to run additional commands or modify the environment.

  • WSL 명령줄에서 VS Code를 시작 하는 데 문제가 있나요?Having problems launching VS Code from your WSL command line? 문제 해결 가이드 에는 경로 변수를 변경 하 고, 누락 된 종속성에 대 한 확장 오류를 해결 하 고, Git 줄 문제를 해결 하 고, 원격 컴퓨터에 로컬 VSIX를 설치 하 고, 브라우저 창을 시작 하 고, 웹 소켓이 작동 하지 않거나, 확장 데이터를 저장 하는 오류 등의 팁이 포함 됩니다This troubleshooting guide includes tips on changing path variables, resolving extension errors about missing dependencies, resolving Git line ending issues, installing a local VSIX on a remote machine, launching a browser window, blocker localhost port, web sockets not working, errors storing extension data, and more.

Git 설치(선택 사항)Install Git (optional)

다른 사람과 협업할 계획이거나 GitHub 같은 오픈 소스 사이트에 프로젝트를 호스팅할 계획인 분들을 위해 VS Code는 Git을 사용한 버전 제어를 지원합니다.If you plan to collaborate with others, or host your project on an open-source site (like GitHub), VS Code supports version control with Git. VS Code의 소스 제어 탭은 모든 변경 내용을 추적하며, UI에 바로 빌드된 일반적인 Git 명령(추가, 커밋, 푸시, 끌어오기)를 포함하고 있습니다.The Source Control tab in VS Code tracks all of your changes and has common Git commands (add, commit, push, pull) built right into the UI.

Git를 설치 하려면 Linux 용 Windows 하위 시스템을 사용 하도록 git 설정을 참조 하세요.To install Git, see set up Git to work with Windows Subsystem for Linux.

Windows 터미널 설치(선택 사항)Install Windows Terminal (optional)

새 Windows 터미널을 사용 하면 여러 탭 (명령 프롬프트, PowerShell 또는 여러 Linux 배포 간을 신속 하 게 전환), 사용자 지정 키 바인딩 (열기 또는 닫기 탭에 대 한 사용자 고유의 바로 가기 키 만들기, 복사 + 붙여넣기 등),이 모 지 ☺ 및 사용자 지정 테마 (색 구성표, 글꼴 스타일 및 크기, 배경 이미지/흐림/투명도)를 사용할 수 있습니다.The new Windows Terminal enables multiple tabs (quickly switch between Command Prompt, PowerShell, or multiple Linux distributions), custom key bindings (create your own shortcut keys for opening or closing tabs, copy+paste, etc.), emojis ☺, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). 자세한 내용은 Windows 터미널 문서를 확인 하세요.Learn more in the Windows Terminal docs.

  1. 다음과 같이 Microsoft Store에서 Windows 터미널을 받습니다. Microsoft Store를 통해 설치하면 업데이트가 자동으로 처리됩니다.Get Windows Terminal in the Microsoft Store: By installing via the store, updates are handled automatically.

  2. 설치가 완료되면 Windows 터미널을 열고 설정을 선택한 다음, profile.json 파일을 사용하여 터미널을 사용자 지정합니다.Once installed, open Windows Terminal and select Settings to customize your terminal using the profile.json file.

추가 리소스Additional Resources

다음과 같은 몇 가지 추가 확장도 고려해 볼 수 있습니다.A few additional extensions you may want to consider include:

  • 다른 편집기의 키맵: Atom, Sublime, Vim, eMacs, 메모장++ 등의 다른 텍스트 편집기에서 전환할 때 이러한 확장을 사용하여 익숙한 환경을 만들 수 있습니다.Keymaps from other editors: These extensions can help your environment feel right at home if you're transitioning from another text editor (like Atom, Sublime, Vim, eMacs, Notepad++, etc).
  • 설정 동기화: GitHub를 사용하는 여러 설치에서 VS Code 설정을 동기화할 수 있습니다.Settings Sync: Enables you to synchronize your VS Code settings across different installations using GitHub. 여러 머신에서 작업하는 경우 이렇게 하면 여러 머신의 환경을 일관되게 유지할 수 있습니다.If you work on different machines, this helps keep your environment consistent across them.
  • Chrome 용 디버거: Linux를 사용 하 여 서버 쪽에서 개발을 마친 후에는 클라이언트 쪽을 개발 하 고 테스트 해야 합니다.Debugger for Chrome: Once you finish developing on the server side with Linux, you'll need to develop and test the client side. 이 확장은 VS Code 편집기를 Chrome 브라우저 디버깅 서비스와 통합하여 효율성을 높입니다.This extension integrates your VS Code editor with your Chrome browser debugging service, making things a bit more efficient.