Skip to content

VS Code 확장

TIP

이 페이지는 Oxc VS Code 확장에 기여하는 방법을 다룹니다. 확장을 내려받으려면 Visual Studio Marketplace 또는 Open VSX Registry를 참고하세요.

개발

oxc-vscode 저장소를 클론한 뒤 pnpm install을 실행합니다.

로컬에서 빌드·실행

Oxc VS Code 확장을 수정해 실행·테스트하는 방법은 두 가지입니다.

명령줄에서:

  • pnpm build로 VS Code 확장을 컴파일하고 언어 서버 release 빌드를 만듭니다.
  • pnpm install-extension으로 VS Code에 설치합니다.
  • Ctrl + Shift + P로 "Developer: Reload Window"를 검색해 실행합니다.
  • 이제 VS Code 안에서 변경 사항을 직접 시험할 수 있습니다.

VS Code에서:

  • oxc-vscode 저장소를 VS Code로 엽니다.
  • 왼쪽 사이드바의 "Run and Debug"로 이동합니다.
  • Launch VS Code Extension 구성을 선택합니다.
  • 상단의 초록색 재생 버튼을 누릅니다.
  • 빌드된 확장이 설치된 새 VS Code 창이 열립니다.

아직 릴리스되지 않은 oxlint/oxfmt 테스트

oxc 프로젝트에서 다음으로 빌드합니다.

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

확장이 로컬 빌드를 쓰도록 settings.json에서 설정합니다.

json
{
  "oxc.path.oxlint": "/path/to/oxc/apps/oxlint/dist/cli.js",
  "oxc.path.oxfmt": "/path/to/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 또는 Rust 크레이트 oxc_language_server에 추가합니다.

예:

  • VS Code: 상태 표시줄 변경
  • oxlint: 반환된 진단·코드 액션
  • oxc_language_server: 워크스페이스 문제