Open VSX에서 '확장 기능 버전 불일치 오류'가 발생했을 때의 대처법

원문 발행 2026. 06. 04. 23:07원문 언어 일본어AI 한국어 번역Zenn AI 원문 보기

요약

Open VSX를 사용하는 포크된 IDE에서 발생하는 확장 기능 버전 불일치 오류의 원인과 해결 방법을 설명합니다. IDE의 고유 버전과 VS Code 기준 버전 간의 차이를 product.json 파일의 ideVersion 수정을 통해 해결하는 절차를 다룹니다.

※본 기사는 생성형 AI의 도움을 받아 작성되었습니다.

Google Antigravity 등 VS Code를 베이스로 포크(Fork)된 IDE를 이용하다 보면, 확장 기능(Extension)을 설치하려고 할 때 다음과 같은 오류를 마주할 수 있습니다.

"Extension is not compatible with Code X.X.X. Extension requires: ^1.XX.0."

이는 IDE 고유의 버전 표기(예: 1.23.2)와 Open VSX의 확장 기능 측에서 요구하는 본가 VS Code의 버전 기준(예: ^1.85.0)이 맞지 않아 발생하는 버전 판정 버그(사양의 차이)입니다.

본 기사에서는 이 오류를 근본적으로 해결하고, 확장 기능을 도입 및 활성화하기 위한 절차를 해설합니다.

해결책: IDE의 코어 설정 파일인 product.json을 직접 편집하여 내부의 버전 차이를 해소합니다.

Ubuntu / Linux: /usr/share/antigravity/resources/app/product.json
Windows: C:\Users\<사용자명>\AppData\Local\Programs\antigravity\resources\app\product.json
Mac: /Applications/Antigravity.app/Contents/Resources/app/product.json

파일을 관리자 권한의 텍스트 에디터로 엽니다.

상단에 있는 `

AI 자동 생성 콘텐츠