Web IDE

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

플래그: Self-managed GitLab에서는 기본적으로 이 기능을 사용할 수 있습니다. 이 기능을 숨기려면 관리자가 피처 플래그로 명명된 vscode_web_ide를 비활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated의 경우에는 이 기능을 사용할 수 있습니다.

Web IDE는 커밋 스테이징이 가능한 고급 편집기입니다. Web IDE를 사용하여 GitLab UI에서 여러 파일에 직접 변경을 가할 수 있습니다. 더 기본적인 구현은 Web Editor를 참조하세요.

Web IDE를 원격 개발 환경과 함께 사용하려면 Remote development를 참조하세요.

Web IDE 열기

Web IDE를 열려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. . 키보드 단축키를 사용합니다.

파일 또는 디렉터리에서

파일이나 디렉터리에서 Web IDE를 열려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 파일이나 디렉터리로 이동합니다.
  3. 편집 > Web IDE에서 열기를 선택합니다.

Merge Request에서

Merge Request에서 Web IDE를 열려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Merge Request으로 이동합니다.
  3. 오른쪽 상단에서 코드 > Web IDE에서 열기를 선택합니다.

Web IDE는 새로운 파일과 수정된 파일을 따로 탭으로 열고 변경 사항을 옆으로 표시합니다. 로드 시간을 줄이기 위해, 변경된 줄이 가장 많은 10개의 파일만 자동으로 열립니다.

왼쪽 탐색기 사이드바에서 어떤 새로운 파일이나 수정된 파일은 파일 이름 옆에 Merge Request 아이콘()으로 표시됩니다. 파일의 변경 사항을 보려면 파일을 마우스 오른쪽 버튼으로 클릭하고 Merge Request 베이스와 비교를 선택합니다.

파일 열기

Web IDE에서 파일 이름으로 파일 열기:

  1. Command+P를 누릅니다.
  2. 검색 상자에 파일 이름을 입력합니다.

열린 파일 검색

Web IDE에서 열린 파일을 검색하려면:

  1. Shift+Command+F를 누릅니다.
  2. 검색 상자에 검색어를 입력합니다.

수정된 파일 디렉터리 보기

Web IDE에서 수정한 파일 디렉터리을 보려면:

  • 왼쪽 활동 표준 모음에서 소스 제어를 선택하거나 Control+Shift+G를 눌러 실행합니다.

수정한 CHANGES, STAGED CHANGES, MERGE CHANGES가 표시됩니다. 자세한 내용은 VS Code documentation를 참조하세요.

커밋되지 않은 변경 사항 복구

Web IDE에서 수정한 파일을 매뉴얼으로 저장할 필요가 없습니다. 수정한 파일은 자동으로 스테이징되며 커밋할 수 있습니다. 커밋되지 않은 변경 사항은 브라우저의 로컬 리포지터리에 저장되며 웹 IDE를 닫거나 새로 고침해도 계속 유지됩니다.

커밋되지 않은 변경 사항이 없는 경우 로컬 히스토리에서 변경 사항을 복구할 수 있습니다. Web IDE에서 커밋되지 않은 변경 사항을 복구하려면:

  1. Shift+Command+P를 누릅니다.
  2. 검색 상자에 Local History: Find Entry to Restore를 입력합니다.
  3. 변경된 사항을 포함하는 파일을 선택합니다.

파일 업로드

Web IDE에서 파일을 업로드하려면:

  1. 왼쪽 활동 표준 모음에서 탐색기를 선택하거나 Shift+Command+E를 눌러 실행합니다.

  2. 파일을 업로드할 디렉터리로 이동합니다. 새 디렉터리를 만들려면:

    • 왼쪽 탐색기 사이드바에서 오른쪽 상단에 새 폴더 만들기를 선택합니다 ().
  3. 디렉터리를 마우스 오른쪽 버튼으로 클릭하고 업로드를 선택합니다.
  4. 업로드할 파일을 선택합니다.

여러 파일을 한꺼번에 업로드할 수 있습니다. 파일이 업로드되고 자동으로 리포지터리에 추가됩니다.

브랜치 전환

Web IDE는 기본적으로 현재 브랜치를 사용합니다. Web IDE에서 브랜치를 전환하려면:

  1. 하단 상태 표준 모음에서 왼쪽에 현재 브랜치 이름을 선택합니다.
  2. 입력하거나 기존 브랜치를 선택합니다.

브랜치 만들기

Web IDE에서 현재 브랜치에서 새 브랜치 만들기:

  1. 하단 상태 표준 모음에서 왼쪽에 현재 브랜치 이름을 선택합니다.
  2. 드롭다운 디렉터리에서 새로운 브랜치 만들기를 선택합니다.
  3. 새로운 브랜치 이름을 입력합니다.

만일 리포지터리에 쓰기 권한이 없다면 새 브랜치 만들기가 표시되지 않습니다.

변경 사항 커밋

Web IDE에서 변경 사항을 커밋하려면:

  1. 왼쪽 활동 표준 모음에서 소스 제어를 선택하거나 Control+Shift+G를 눌러 실행합니다.
  2. 커밋 메시지를 입력합니다.
  3. 현재 브랜치에 커밋하거나 새 브랜치를 만듭니다.

Merge Request 만들기

Web IDE에서 Merge Request을 생성하려면:

  1. 변경 사항을 커밋합니다.
  2. 오른쪽 하단에 나타나는 알림에서 MR 만들기를 선택합니다.

자세한 내용은 놓친 알림 보기를 참조하세요.

명령 파레트 사용

명령 파레트를 사용하여 다양한 명령어에 액세스할 수 있습니다. Web IDE에서 명령 파레트를 열고 명령어를 실행하려면:

  1. Shift+Command+P를 누릅니다.
  2. 명령어를 입력하거나 선택합니다.

설정 편집

사용자 및 작업 공간 설정을 보고 수정할 수 있는 설정 편집기를 사용할 수 있습니다. 웹 IDE에서 설정 편집기를 열려면:

  • 상위 메뉴 막대에서 파일 > 기본 설정 > 설정을 선택하거나, 또는 Command+,를 누릅니다.

설정 편집기에서 수정하고자 하는 설정을 검색할 수 있습니다.

키보드 단축키 편집

사용 가능한 모든 명령에 대한 기본 키 바인딩을 보고 수정할 수 있는 키보드 단축키 편집기를 사용할 수 있습니다. 웹 IDE에서 키보드 단축키 편집기를 열려면:

  • 상위 메뉴 막대에서 파일 > 기본 설정 > 키보드 단축키를 선택하거나, 또는 Command+K를 누른 후 Command+S를 누릅니다.

키보드 단축키 편집기에서 다음을 검색할 수 있습니다:

  • 변경하려는 키 바인딩
  • 추가하거나 제거하려는 명령

키 바인딩은 키보드 레이아웃에 기반합니다. 키보드 레이아웃을 변경하면 기존의 키 바인딩이 자동으로 업데이트됩니다.

색 테마 변경

웹 IDE의 다양한 색 테마 중에서 선택할 수 있습니다. 기본 테마는 GitLab Dark입니다.

웹 IDE에서 색 테마를 변경하려면:

  1. 상위 메뉴 막대에서 파일 > 기본 설정 > 테마 > 색 테마를 선택하거나, 또는 Command+K를 누른 후 Command+T를 누릅니다.
  2. 드롭다운 디렉터리에서 화살표 키로 테마를 미리보기합니다.
  3. 테마를 선택합니다.

활성 색 테마는 사용자 설정에 저장됩니다.

놓친 알림 보기

웹 IDE에서 작업을 수행하면 아래 오른쪽에 알림이 표시됩니다. 놓칠 수 있는 모든 알림을 보려면:

  1. 하단 상태 막대에서 오른쪽에 있는 종 아이콘()을 선택하여 알림 디렉터리을 표시합니다.
  2. 보고 싶은 알림을 선택합니다.

상호 작용 웹 터미널

상태: 베타
caution
이 기능은 베타 상태이며 사전 통지 없이 변경될 수 있습니다.

웹 IDE에서 원격 개발 서버를 설정하면 상호 작용 웹 터미널을 사용할 수 있습니다:

  • 서버에서 원격 셸에 액세스할 수 있습니다.
  • 서버의 파일 시스템에 상호 작용하고 원격으로 명령을 실행할 수 있습니다.

상호 작용 웹 터미널을 사용하여 러너와 상호 작용할 수 없습니다. 그러나 의존성을 설치하고 코드를 컴파일하고 디버깅하기 위해 터미널을 사용할 수 있습니다.

자세한 정보는 원격 개발을 참조하십시오.

관련 주제

문제 해결

웹 IDE를 사용하는 동안 다음과 같은 문제가 발생할 수 있습니다.

입력 중 문자 오프셋

웹 IDE에서 입력하는 동안 4개의 문자 오프셋이 발생할 수 있습니다. 해결 방법은 다음과 같습니다:

  1. 상위 메뉴 막대에서 파일 > 기본 설정 > 설정을 선택하거나, 또는 Command+,를 누릅니다.
  2. 오른쪽 상단에서 설정 열기(JSON)을 선택합니다.
  3. settings.json 파일에서 "editor.disableMonospaceOptimizations": true를 추가하거나 "editor.fontFamily" 설정을 수정합니다.

자세한 정보는 VS Code issue 80170을 참조하십시오.