파이썬 VS Code 자동완성 끄기 및 인라인 제안 비활성화 방법

 

파이썬 코드를 작성하다 보면 화면에 실시간으로 다음 코드가 미리 보이거나, 노란색 팝업창이 떠서 코드를 가리는 경우가 많습니다.

이 기능은 코딩을 도와주는 자동완성(IntelliSense) 및 인라인 제안 기능입니다. 하지만 초보자 단계에서 코드를 직접 타이핑하며 연습할 때는 오히려 흐름을 방해하고 화면을 복잡하게 만들어 비활성화하는 것이 좋습니다.

가장 많이 사용하는 에디터인 VS Code(Visual Studio Code)를 기준으로, 옆에서 자꾸 코드를 미리 알려주는 기능을 깔끔하게 끄는 방법을 정리해 드립니다.

VS Code 인라인 제안 및 자동 완성 끄기

회색 글씨로 미리 보여주는 인라인 제안 비활성화하기

코드 옆이나 뒤에 흐릿한 회색 글씨로 다음 코드를 예측해서 보여주는 기능은 '인라인 제안(Inline Suggest)' 기능입니다.

이 기능을 끄려면 VS Code에서 설정 창을 열어야 합니다. 단축키 Ctrl + , (Mac은 Cmd + ,)를 누른 후, 상단 검색창에 inline suggest를 검색합니다. 검색 결과에 나오는 Editor > Inline Suggest: Enabled 항목의 체크박스를 해제하면 회색 글씨 예측 기능이 즉시 꺼집니다.

타이핑할 때마다 나타나는 팝업창 박스 숨기기

단어를 입력할 때마다 아래나 옆으로 추천 명령어 목록이 담긴 박스가 튀어나오는 것을 막고 싶다면 자동 완성 제안을 제어해야 합니다.

설정 검색창에 quick suggestions를 검색합니다. Editor > Quick Suggestions 항목을 찾은 뒤, 아래에 나오는 other, comments, strings 등의 옵션 값을 모두 on에서 off로 변경합니다. 이렇게 하면 타이핑할 때 자동으로 팝업창이 뜨지 않습니다.

설정 파일 수정을 통한 확실한 비활성화 방법

settings.json 파일 직접 편집하여 기능 차단하기

설정 메뉴를 일일이 찾기 번거롭다면 설정 창 우측 상단에 있는 단추 모양의 '설정 열기(JSON)' 아이콘을 클릭해 텍스트로 한 번에 제어할 수 있습니다.

설정 파일이 열리면 중괄호 {} 안에 아래의 코드를 그대로 복사해서 붙여넣고 저장(Ctrl + S)하면 됩니다. 이 방법은 에디터의 불필요한 제안 기능을 가장 확실하게 차단하는 방법입니다.

JSON

{
  "editor.inlineSuggest.enabled": false,
  "editor.quickSuggestions": {
    "other": "off",
    "comments": "off",
    "strings": "off"
  },
  "editor.suggestOnTriggerCharacters": false
}

필요할 때만 수동으로 자동완성 팝업 띄우기

자동완성 기능을 완전히 꺼두었다가, 특정 명령어가 생각이 나지 않아 도움이 필요할 때만 선택적으로 켤 수도 있습니다.

위 설정을 적용해 자동 팝업을 꺼둔 상태에서 코딩을 하다가, 단축키 Ctrl + Space를 누르면 그 순간에만 필요한 자동완성 추천 창이 화면에 나타납니다. 평소에는 화면을 깔끔하게 유지하고 필요할 때만 도움을 받을 수 있어 효율적입니다.

자주 묻는 질문

Q1. 파이썬 자동완성을 껐는데도 빨간색 밑줄이 자꾸 생기는 이유는 무엇인가요?

A1. 코드 아래에 생기는 빨간색 꼬불꼬불한 밑줄은 자동완성이 아니라 문법 오류를 잡아주는 린터(Linter) 기능 때문입니다. 이미지 속 코드처럼 들여쓰기(IndentationError)가 잘못되었거나 오타가 있을 때 발생하므로, 문법 규칙에 맞게 코드를 수정하면 사라집니다.

Q2. 끄고 나니 불편한데 나중에 다시 원래대로 켜려면 어떻게 하나요?

A2. 단축키 Ctrl + ,를 눌러 설정으로 이동한 뒤, 변경했던 Inline Suggest 체크박스를 다시 체크하고 Quick Suggestions 설정을 on으로 돌려놓으면 언제든지 이전 상태로 복구할 수 있습니다.

Q3. 파이썬 확장 프로그램(Extension) 때문에 생기는 알림도 끌 수 있나요?

A3. Pylance나 Tabnine 같은 인공지능 코딩 전문 확장 프로그램이 설치되어 있다면 자체적으로 제안을 보낼 수 있습니다. 이 경우 VS Code 좌측 확장 탭(Ctrl + Shift + X)에서 해당 프로그램을 찾아 잠시 '사용 안 함(Disable)'으로 설정하시면 됩니다.