VSCode용 Google Java Format 확장 개발

 

VSCode용 Google Java Format 확장 개발

어떤 분이 간단히 만들어 둔 Google Java Format 확장에 기능을 덧붙여,

마켓플레이스에 올리지 않고 로컬에서만 설치해 사용하고 있었다.

그런데 원본 확장의 업데이트가 끊긴 지 5년이 넘었고, 내가 수정한 버전을 로컬에서만 쓰는 것도 점점 불편해졌다.

그래서 아예 새로 만들기로 했다.

아래는 그렇게 만든 확장이다.

GitHub 리포지토리

👇확장 설명서 (README.md)

Google Java Format for VSCode

VSCode에서 google-java-format을 Java 포매터로 사용할 수 있게 해주는 확장입니다.

기능

  • Java 파일을 google-java-format 규칙으로 포맷합니다.

  • Native 실행 파일과 JAR 실행 방식을 모두 지원합니다.

  • 설정 화면에서 실행 방식과 실행 파일 경로를 지정할 수 있습니다.

설정 화면




요구사항

  • VSCode 1.120.0 이상

  • google-java-format 실행 파일

    • Native 방식: OS에 맞는 native image 실행 파일

    • JAR 방식: google-java-format-<version>-all-deps.jar

  • JAR 방식 사용 시 Java 실행 환경

google-java-format 파일은 google-java-format Releases에서 받을 수 있습니다.


확장 설정

실행 방식

  • gjfe.executionType: google-java-format 실행 방식을 선택합니다.

선택 가능한 값은 다음과 같습니다.

  • native: native image 실행 파일을 사용합니다.

  • jar: JAR 파일을 Java로 실행합니다.

google-java-format 1.20.0부터 native image가 제공됩니다. 일반적으로 JAR 방식보다 실행 속도가 빠르므로, 사용할 수 있는 환경이라면 native 방식을 권장합니다.

Native 실행 방식

  • gjfe.nativeImagePath: native image 실행 파일의 전체 경로입니다.

예:

C:\google-java-format\google-java-format_windows-x86-64.exe

JAR 실행 방식

  • gjfe.jarPath: google-java-format JAR 파일의 전체 경로입니다.

  • gjfe.javaHome: JAR 파일을 실행할 때 사용할 JAVA_HOME 경로입니다.

  • gjfe.jvmOptions: JAR 파일 실행 시 추가할 JVM 옵션 목록입니다.

설정값 예시:

gjfe.jarPath

  • C:\git-other\google-java-format\core\target\google-java-format-1.35.0-all-deps.jar

gjfe.javaHome

  • C:\JDK\21

Java 17 이상에서 google-java-format을 JAR 방식으로 실행할 때 JDK 내부 API 접근이 제한될 수 있습니다. 이 확장은 다음 --add-exports 옵션을 기본값으로 제공합니다.

--add-exports=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED

이 확장은 --add-exports 옵션에 대해서 등호 없이 입력한 값도 실행 가능한 형태로 처리하지만, 등호(=)를 사용하는 형식을 권장합니다.

알려진 이슈

  • 현재 등록된 알려진 이슈가 없습니다.

릴리스 노트

0.0.1

  • 최초 릴리스

  • Native 실행 방식 지원

  • JAR 실행 방식 지원



후기

직접 만들어 보니 생각보다 꽤 만족스럽다.

로컬에서 VSCode 확장을 개발하는 흐름도 전보다 훨씬 잘 이해하게 됐다.

조금 더 사용해 보고 문제가 없으면 마켓플레이스에도 배포해 보자. 😊

그리고,

지금은 Google Java Format GitHub 사이트에서 native 실행 파일을 수동으로 내려받아 설정하고 있지만,

다음 버전에서는 native 실행 파일 자동 업데이트 기능도 꼭 추가해 보자. 👍

 

💡추가 사항으로...

VSIX 확장 프로젝트를 처음 생성한 직후, Node.js 환경에서 제공하는 전역 객체(process, Buffer 등), Visual Studio Code 확장 API(vscode.window, vscode.commands 등), 그리고 Mocha 테스트 프레임워크에서 사용하는 함수(describe, it 등)와 같은 내장 변수 및 타입을 TypeScript 컴파일러가 인식하지 못하는 오류가 발생할 수 있다.

이러한 문제를 해결하기 위해서는 tsconfig.json 파일의 compilerOptions 항목에 types 옵션을 명시적으로 추가하여, 프로젝트가 Node.js, VS Code API, Mocha의 타입 정의를 포함하도록 설정해야 한다.

예시는 다음과 같다.

{
  "compilerOptions": {
    ...
    "types": ["node", "vscode", "mocha"],
    ...
  }
}

위와 같이 설정하면 TypeScript가 해당 타입 정의 파일(@types/node, @types/vscode, @types/mocha)을 올바르게 로드하여, 내장 변수 및 API 호출 시 발생하던 “정의되지 않은 식별자” 오류를 방지할 수 있으며, 코드 작성 시 자동 완성과 타입 검사 기능을 정상적으로 활용할 수 있다.


 

Antigravity, Cursor에 설치시 버전 호환 문제 해결

이후에 Cursor나 Antigravity에도 잘 설치되는지 확인해보았는데...

1.120 버전 기준이 비교적 최신이라서 그런지? 설치를 할 수가 없었다. 😂

2026년 6월 기준으로 각 VSCode 기반 IDE들의 버전을 보면 아래와 같은데...


Antigravity: 1.107.0

Cursor: 1.105.1

 

VSCode: 1.123.0

 


확인해봤을 때.. 버전 정보들이 위와 같아서...

가장 낮은 버전인 1.105.1로 하향 조정했다.

.vscode-test.mjs

import { defineConfig } from "@vscode/test-cli";
​
export default defineConfig({
  files: "out/test/**/*.test.js",
  // 2026/06/09 기준
  // - Cursor:           1.105.1
  // - Antigravity IDE:  1.107.0
  // - VSCode:           1.123.0
  version: "1.105.1",
});

package.json

  "engines": {
    "vscode": "^1.105.1"
  },
  ...
  "devDependencies": {
    ...
    "@types/vscode": "^1.105.1",
    ...

이런식으로 다시 바꾸고 다시 vsix로 패키지해서 Cursor와 Antigravity에 설치해봤을 때...

잘 동작했다. 😊👍👍



 

 

 

댓글

댓글 쓰기

이 블로그의 인기 게시물

한글 2005 가정용

이미지
가격 : 옆에 살짝 보이는 한글815판의 2배정도 가격 가정용으로 쓰는데는 문제없어 보이지만, 판매처에 대한 제한이 있군요. 상업용에 비해서 사용자 설명서가 간단하지만,  (상업용의 경우 설명서가 190페이지정도의 책입니다.) DVD케이스에 설치시디를 넣어준 것은 잘한 것 같습니다. (상업용은 일반 더블시디 플라스틱 투명 케이스 ) 한컴사전, 타자연습 기타 등등... 2개의 시디 구성은 상업용 제품과 동일합니다. 원래 설치하자마자 [한글 2005의 정보]를 보면 이곳에서도 가정용 마크가 붙어 있지만, [한컴업데이트]를 통한 인터넷 업데이트 후에는 상업용과 마찬가지로 가정용 이미지가 없어집니다. (가정용이라고 따로 패치를 만들면 번거롭겠지요.) 현재 최신버전은 6.7.7.1020 이군요. 장점 : 상업용 정품에 비해 무척이나 저렴한 가격. 상업용 정품과 같은 시디 구성 단점 : 가정에서만 사용가능. 판매처를 제한해 둔 것. 한컴에서 공식적으로 판매하지 않는 것.    구매사이트에서 보니, 구매한 사용자가 꽤 많았습니다. 가정사용자용으로, 어느정도 가격만 맞다면, 정품사용자도 충분히 증가할 수 있다는 생각이 드네요, 이런 가정용 판매가 공식적, 일반적으로 잘 이루어졌으면 좋겠습니다. 작성일 : 2007-06-09 22:26:05 링크 : http://keben.kbench.com/photo/?bc=67&pg=1&total=21&sb=3&sp=0&sc=lantool&code=2255378 Kbench 갤러리 백업 지금은 한컴도 한컴오피스2010 Home Edtion(가정용)을 판매처 제한 없이 팔고있으니 예전에 비해 구입여건이 좋아졌다.  
자세한 내용 보기

V3Pro 2002 Deluxe

이미지
ESD보단 패키지가 좋더군요. 작성일 : 2007-05-15 03:49:10 링크 : http://keben.kbench.com/photo/?bc=67&pg=1&total=21&sb=3&sp=0&sc=lantool&code=2251265 Kbench 갤러리 백업 ESD는 그냥 다운로드 방식인데, 내가 왜이렇게 썼지? DSP 잘못 쓴건가.. 거의 1년 마다 갱신하는 백신 제품은 그냥 ESD 사용하는 것이 나을 것 같다. 몇년 갱신하다보면 패키지가 쌓여감.. 현재는 V3 365클리닉으로 사용
자세한 내용 보기

전자정부 프레임워크 v5.0 교육자료 IDE, 다른 드라이브에 설치하는 완벽 가이드

이미지
  전자정부 프레임워크 v5.0 교육자료 IDE, 다른 드라이브에 설치하는 완벽 가이드 한 달 전쯤 전자정부 프레임워크(eGovFrame) v4.3 교육을 들었을 때는, 설치 가이드에 나와 있는 대로 얌전하게 C 드라이브( C:\ )에 설치했었습니다. 하지만 이번 최신 v5.0 교육을 들으면서는 조금 다른 시도를 해보기로 했죠. 바로 용량이 넉넉한 다른 드라이브(제 경우는 G:\ )에 설치해보는 것입니다! 개발 프로그램들이 워낙 용량을 많이 차지하다 보니, 항상 C 드라이브 공간이 부족해 허덕이게 되더라고요. 저처럼 C 드라이브 용량 압박에 시달리시는 분들을 위해, 다른 드라이브에 전자정부 프레임워크 IDE를 세팅하는 과정을 꼼꼼히 정리해 보았습니다. (💡 바쁘신 분들을 위해 글 맨 마지막에 '단 1초 만에 해결하는 초간단 꿀팁(정션 링크)' 도 적어두었으니 참고해 주세요!) 📌 교육자료 다운로드 및 기본 경로 확인 👉 다운로드 링크: eGovFrame 다운로드 페이지 기본적으로 가이드에서는 아래와 같이 C:\ 하위에 압축을 풀게 되어 있습니다. ✔️ eclipse IDE: C:\eGovFrame-5.0.0\eclipse ✔️ maven: C:\eGovFrame-5.0.0\maven 　💡로컬 리포지토리 포함 (.m2) ✔️ 교재 자료 경로: C:\eGovFrame-5.0.0\textbook ✔️ 실습 자료 경로: 　📂 C:\eGovFrame-5.0.0\workspace-edu 　📂 C:\eGovFrame-5.0.0\workspace-mobile 　📂 C:\eGovFrame-5.0.0\workspace-vscode 하지만 저는 C:\ 대신 G:\ 드라이브에 압축을 풀고 세팅을 변경해 주었습니다. 📌 1. 로컬 메이븐 설정(settings.xml) 변경하기 가장 먼저 해야 할 일은 Maven의 로컬 리포지토리(Local...
자세한 내용 보기