프로파간다 전체 글

코드 에디터 확장 프로그램이 안 될 때 해결 순서와 링크모아 활용

개발도구 관련 대표 사진
사진: fancycrave1 / Pixabay

코드 에디터는 확장 프로그램 덕분에 훨씬 편리해집니다. 문법 강조, 자동 완성, 코드 정렬, 원격 접속까지 필요한 기능을 골라 붙일 수 있기 때문입니다. 그런데 어느 날 갑자기 자동 완성이 뜨지 않거나, 저장할 때 코드 정렬이 되지 않거나, 에디터 전체가 눈에 띄게 느려지는 일이 생기기도 합니다. 이럴 때 에디터를 지우고 처음부터 다시 설치하는 것은 마지막 수단입니다. 대부분은 아래 순서대로 원인을 좁혀 가면 짧은 시간 안에 해결할 수 있습니다.

원인을 좁혀 가는 여섯 단계

1단계, 에디터와 확장 버전 확인하기

가장 먼저 에디터와 확장 프로그램이 최신 버전인지 확인합니다. 에디터가 자동 업데이트된 뒤 확장이 아직 새 버전을 지원하지 않거나, 반대로 확장만 업데이트되어 오래된 에디터와 맞지 않는 경우가 흔합니다. 확장 상세 페이지의 변경 기록을 보면 최근 업데이트에서 알려진 문제가 있는지 확인할 수 있습니다. 문제가 업데이트 직후 시작됐다면 이전 버전으로 되돌리는 기능을 써 보는 것도 방법입니다.

2단계, 에디터 완전히 다시 시작하기

단순하지만 효과가 큰 방법입니다. 창만 닫지 말고 에디터 프로세스를 완전히 종료한 뒤 다시 실행하세요. 확장 프로그램은 백그라운드에서 별도로 동작하는 경우가 많아서, 하나가 멈추면 다른 기능까지 영향을 받습니다. 많은 에디터가 명령 팔레트에서 창 다시 불러오기나 확장 호스트 재시작 같은 명령을 제공하니 이를 활용해도 됩니다.

3단계, 출력 로그와 개발자 도구 확인하기

다시 시작해도 해결되지 않는다면 로그를 볼 차례입니다. 에디터 하단의 출력 패널에서 문제가 되는 확장 이름을 선택하면 오류 메시지가 표시되는 경우가 많습니다. 메시지에 특정 실행 파일을 찾을 수 없다는 내용이 있다면 확장이 의존하는 언어 런타임이나 도구가 설치되지 않았거나 경로가 잘못 설정된 것입니다. 오류 문구를 그대로 복사해 확장의 공식 이슈 게시판에서 검색하면 같은 문제를 겪은 사람의 해결책을 찾을 수 있습니다.

개발도구 주제와 어울리는 사진
사진: googlerankfaster / Pixabay

4단계, 확장끼리 충돌하는지 점검하기

비슷한 기능을 하는 확장을 여러 개 설치하면 서로 충돌할 수 있습니다. 예를 들어 코드 정렬 확장이 두 개 있으면 저장할 때 어느 쪽이 동작할지 헷갈려 아무것도 하지 않거나 결과가 매번 달라집니다. 모든 확장을 끈 상태로 에디터를 실행하는 옵션을 써서 문제가 사라지는지 확인하고, 사라진다면 확장을 절반씩 다시 켜면서 원인을 좁혀 가세요. 이 방식은 확장이 많을 때 특히 빠르게 범인을 찾아 줍니다.

5단계, 설정 파일 점검하기

사용자 설정과 작업 폴더 설정이 서로 다르게 지정되어 있으면 확장이 예상과 다르게 동작할 수 있습니다. 작업 폴더에 별도 설정 파일이 있다면 그 안의 값이 사용자 설정보다 우선 적용되는 경우가 많습니다. 최근에 바꾼 설정이 있다면 되돌려 보고, 설정 동기화 기능을 쓰고 있다면 다른 컴퓨터에서 바꾼 설정이 넘어오지 않았는지도 확인하세요.

6단계, 확장 삭제 후 재설치하기

위 단계로도 해결되지 않는다면 문제가 되는 확장만 삭제한 뒤 다시 설치합니다. 삭제 후에는 에디터를 한 번 다시 시작하고 설치하는 것이 좋습니다. 확장이 남긴 캐시 폴더가 문제를 일으키는 경우도 있으니, 공식 문서에 캐시 위치가 안내되어 있다면 함께 정리해 보세요.

주소모음 대신 공식 경로부터 확인하기

확장 프로그램 문제를 해결할 때 가장 중요한 원칙은 공식 경로를 이용하는 것입니다. 에디터의 공식 확장 마켓플레이스, 확장 개발자의 공식 저장소와 이슈 게시판이 가장 정확한 정보를 줍니다. 검색으로 찾은 비공식 설치 파일이나 수정본은 악성 코드가 섞여 있을 위험이 있습니다. 개발 도구의 공식 사이트와 문서 경로를 정리한 개발도구 사이트모음을 북마크해 두면 필요한 문서에 바로 접근할 수 있습니다.

확장을 설치하기 전에는 개발자 정보, 설치 수, 최근 업데이트 시기, 요구하는 권한을 확인하는 습관도 필요합니다. 이름이 유명 확장과 비슷하지만 개발자가 다른 가짜 확장이 등록되는 사례도 있기 때문입니다. 컴퓨터 보안 점검 도구와 백신 공식 경로를 모아 둔 보안백신 링크모음을 함께 활용해 주기적으로 검사하면 더 안심할 수 있습니다. 블로그에 정리된 링크모아 목록이나 주소모아 페이지를 참고하더라도 실제 설치는 공식 마켓플레이스에서 하세요.

같은 문제를 줄이는 관리 습관

문제를 해결했다면 다음을 위해 몇 가지 습관을 들여 두면 좋습니다. 첫째, 쓰지 않는 확장은 과감히 지웁니다. 확장이 많을수록 에디터 시작 속도가 느려지고 충돌 가능성도 커집니다. 한 달에 한 번 정도 설치 목록을 훑어보며 최근에 쓰지 않은 확장을 정리하세요.

둘째, 프로젝트별로 필요한 확장을 나눠 관리합니다. 많은 에디터가 작업 폴더마다 특정 확장만 켜는 기능이나 프로필 기능을 제공합니다. 웹 개발용, 데이터 분석용처럼 프로필을 나눠 두면 서로 다른 언어의 확장이 부딪히는 일이 줄어듭니다.

셋째, 중요한 작업 전에는 자동 업데이트를 잠시 미루는 것도 방법입니다. 마감이 임박한 시기에 업데이트로 문제가 생기면 곤란하니, 여유 있을 때 업데이트하고 이상이 없는지 확인하는 편이 안전합니다. 설정 파일은 백업하거나 동기화 기능으로 보관해 두면 문제가 생겼을 때 빠르게 되돌릴 수 있습니다.

확장 프로그램 오류는 대부분 버전, 충돌, 설정 중 하나에서 시작됩니다. 순서대로 좁혀 가는 습관을 들이면 다음에 같은 문제가 생겨도 당황하지 않고 해결할 수 있습니다.

전체 글 목록주소모아 전체 분야프로파간다 홈