Skip to content

VS Code 확장 프로그램

TIP

이 페이지는 Oxc VS Code 확장 프로그램 기여를 위한 것입니다. 확장 프로그램을 다운로드하려면 Visual Studio Marketplace 또는 Open VSX 레지스트리를 참조하세요.

개발

oxc-vscode 저장소를 클론하고 pnpm install을 실행하세요.

로컬에서 확장 프로그램 빌드 및 실행

Oxc VS Code 확장 프로그램에 대한 변경 사항을 실행하고 테스트하는 두 가지 옵션이 있습니다.

명령행을 통해:

  • pnpm build를 실행하여 VS Code 확장 프로그램을 컴파일하고 언어 서버의 배포 버전을 빌드합니다.
  • pnpm install-extension을 실행하여 확장 프로그램을 VS Code에 설치합니다.
  • Ctrl + Shift + P를 누르고 "개발자: 창 다시 로드"를 검색합니다.
  • 이제 변경 사항을 수동으로 VS Code 내부에서 테스트할 수 있습니다.

VS Code 자체를 통해:

  • VS Code에서 oxc-vscode 저장소를 열기.
  • 에디터 왼쪽 사이드바의 "실행 및 디버깅" 탭으로 이동합니다.
  • Launch VS Code Extension 구성 선택.
  • 상단의 녹색 재생 버튼을 클릭합니다.
  • 이 작업은 VS Code 확장 프로그램을 빌드하고, 새로 빌드된 확장 프로그램이 설치된 새 VS Code 창을 시작합니다.

미출시된 oxlint/oxfmt 버전 테스트

oxc 프로젝트에서 다음 명령을 통해 프로젝트를 빌드합니다:

bash
cd apps/oxlint && pnpm build-test
cd ../oxfmt && pnpm build-test

그런 후 settings.json의 확장 프로그램 설정을 통해 로컬 빌드를 사용하도록 구성합니다:

json
{
  "oxc.path.oxlint": "/경로/oxc/apps/oxlint/dist/cli.js",
  "oxc.path.oxfmt": "/경로/oxc/apps/oxfmt/dist/cli.js"
}

출력 채널 사용

확장 프로그램과 언어 서버가 수행하는 작업을 확인하려면, VS Code의 Oxc 출력 채널을 사용하세요. 더 많은 정보를 얻으려면 settings.json에서 다음 확장 설정을 활성화하세요:

json
{
  "oxc.trace.server": "verbose"
}

oxlint/oxfmt의 언어 서버 통합(예: oxc_language_server 크레이트)에서 info! 또는 error! 매크로를 사용하여 메시지를 VS Code의 Oxc 출력 채널로 전송할 수 있습니다.

테스트 작성

변경 사항에 따라 테스트를 생성해야 합니다. 테스트는 특정하게 VS Code에만 관련될 때만 VS Code 확장 프로그램 내에서 작성해야 합니다. 도구와의 LSP 통신 테스트는 oxlint/oxfmt 또는 러스트 크레이트 oxc_language_server에 추가해야 합니다.

예시:

  • VS Code: 상태 표시줄 변경
  • oxlint: 반환된 진단 결과 / 코드 조치
  • oxc_language_server: 워크스페이스 문제