set options

모든 set 옵션은 set-commands에서 볼 수 있다.

action 명령

:action은 IntelliJ의 내장 기능을 실행해주는 편리한 명령이며, IntelliJ의 대부분의 기능은 :action으로 호출할 수 있는 아이디를 갖고 있다. (IntelliJ 전용이기 때문에 당연히 vim 에서는 쓸 수 없다.)

모든 action은 :actionlist로 볼 수 있다. 3000개가 넘으므로 command + a로 복사해서 다른 곳에 붙여넣고 쓸만한 것이 있는지 찾아보면 된다.

:action 명령을 쓰는 기본적인 방법은 vim 명령행에서 입력하는 것이다.

예를 들어 :action ManageRecentProjects를 입력하고 엔터를 치면 프로젝트 선택 화면이 나온다.

하지만 :action의 진정한 활용은 역시 nmap, map에 있다.

map을 사용해 매핑할 때에는 두 가지 문법을 사용할 수 있다.

다음은 <tab>f에 QuickFixes를 매핑한 예제이다.

nnoremap <Tab>f :action QuickFixes<CR>

<Action>을 사용해도 된다. 이렇게 하면 <CR>을 마지막에 넣지 않아도 되므로 편리하다. 단, 재귀적 사용을 금지하는 noremap 옵션을 쓸 수 없으므로 nnoremap은 못 쓰고 nmap이나 map 만 쓸 수 있다. 어차피 <Action>으로는 IntelliJ의 기능만 호출하므로 당연히 재귀적 사용이 기본적으로 제한되어 있어서 그런 것 같다.

nmap <Tab>f <Action>(QuickFixes)

좀 더 pure vim 스럽게 쓰고 싶다면 그냥 nnoremap … <CR>을 쓰면 되겠다.

" tabbar와 비슷한 느낌으로 사용할 수 있다
nnoremap \t :action ActivateStructureToolWindow<CR>

" startify와 비슷한 느낌으로 최근 프로젝트 이동을 할 수 있다
nnoremap \s :action ManageRecentProjects<CR>

다만 Ideavim 개발자들은 :action Command의 형태보다 <Action>(Command)방식을 권장하고 있다. 단 <Action>(Command) 형식은 noremap과 호환되지 않으므로 그냥 map을 써야 한다.

Ideavim 개발자들은 아예 매핑에 :action을 사용하지 말라고 한다.

Please don't use :action in mappings. Use <Action> instead.

– Ideavim README.md Executing actions 섹션

따라서 위의 설정은 다음과 같이 바꿔 쓰도록 한다.

" tabbar와 비슷한 느낌으로 사용할 수 있다
map \t <Action>(ActivateStructureToolWindow)

" startify와 비슷한 느낌으로 최근 프로젝트 이동을 할 수 있다
map \s <Action>(ManageRecentProjects)

set trackactionids 을 통해 특정 기능의 action 아이디 알아내기

참고: marketplace plugin example

set trackactionids 또는 set tai를 입력하면 IntelliJ의 기능을 사용할 때마다 화면 오른쪽 아래에 해당 기능의 action id를 팝업으로 보여준다.

이 아이디를 사용해서 :action 아이디로 호출하면 해당 기능을 사용할 수 있으므로, nmap 등에 매핑해서 사용하면 된다.

IntelliJ 빌트인 기능 뿐 아니라 marketplace에서 다운로드한 플러그인의 다양한 기능들도 아이디를 알아낼 수 있기 때문에 매우 유용하다.

플러그인

ideavim은 유명한 vim 플러그인의 에뮬레이션을 제공한다.

물론 vim 플러그인을 그대로 쓸 수 있는 것은 아니고, ideavim에서 사용할 수 있도록 만들어진 것이다.

2025-01-25일 기준으로 ideavim에서도 사용할 수 있는 유명한 Vim 플러그인 구현 목록은 다음과 같다.

  • easymotion
  • sneak
  • NERDTree
  • surround
  • multiple-cursors
  • commentary
  • ReplaceWithRegister
  • argtextobj
  • exchange
  • textobj-entire
  • highlightedyank
  • vim-paragraph-motion
  • vim-indent-object
  • matchit.vim
  • IdeaVim-Quickscope
  • Which-Key
  • Vim Peekaboo
  • FunctionTextObj
  • Switch

easymotion

이제 ideavim에도 easymotion이 들어와서 easymotion 스타일로 커서를 이동시킬 수 있게 되었다.

그런데 ideavim 만으로는 작동이 안 된다는 문제가 있다. easymotion을 사용하려면 다음 절차를 거쳐야 한다.

Plug 'easymotion/vim-easymotion'

만약 space를 mapleader로 사용한다면 다음과 같이 키를 매핑할 수 있다.

let mapleader=" "
nmap <Leader>l <Plug>(easymotion-lineforward)
nmap <Leader>j <Plug>(easymotion-j)
nmap <Leader>k <Plug>(easymotion-k)
nmap <Leader>h <Plug>(easymotion-linebackward)
nmap <Leader>a <Plug>(easymotion-jumptoanywhere)

나는 다음과 같이 사용하고 있다.

map <C-s>l <Plug>(easymotion-lineforward)
map <C-s>j <Plug>(easymotion-j)
map <C-s>k <Plug>(easymotion-k)
map <C-s>h <Plug>(easymotion-linebackward)
map <C-s><C-s> <Plug>(easymotion-jumptoanywhere)
map <C-s>f <Plug>(easymotion-f)

NERDTree

https://github.com/JetBrains/ideavim/wiki/NERDTree-support

vim에서의 NERDTree는 아쉬운 점이 많아서 잘 안 쓰는데, Ideavim에서는 Project Explorer 제어 기능으로 포팅이 되면서 엄청 편리한 기능이 되었다.

Ideavim을 쓴다면 NERDTree는 필수 기능이라 생각한다. command + 1로 커서가 프로젝트 익스플로러로 이동한 이후에 j, k로 커서를 이동할 수 있고, 검색도 된다.

Plug 'preservim/nerdtree'
  • j, k - 커서 위/아래 이동.
  • C-j, C-k - 위/아래 sibling 이동.
  • S-j, S-k - sibling 중 마지막, 첫번째로 이동.
  • m - 컨텍스트 메뉴(우클릭).
  • o - 파일 열기.
  • go - 파일은 열지만 커서는 프로젝트 익스플로러에 남아 있음.
  • / - 파일 이름 검색.
  • p - 현재 커서가 위치한 노드의 직계 부모 노드로 이동.
  • P - 최상위 노드로 이동. 즉 프로젝트 루트 디렉토리로 이동.

제공하는 명령은 여러가지가 있지만 굳이 다 알 거 없고 NERDTreeFind 하나면 알아도 충분한 것 같다.

Project Explorer를 활성화 시키면서 현재 편집중인 파일을 하이라이트시켜준다. IntelliJ의 기본 키 제어로는 option - F1, 1을 써야 했는데, 이제는 이렇게 설정해서 쓴다.

nmap sff :NERDTreeFind<CR>

그런데 시간이 흐르며 NERDTreeFind와 똑같은 기능을 하는 :action이 생겼다. SelectInProjectView.

그래서 요즘은 다음과 같이 사용하고 있다.

map sff <Action>(SelectInProjectView)

surround

surround 는 vim의 vim-surround와 똑같은 느낌으로 사용할 수 있었다.

surround를 사용하려면 .ideavimrc에 다음과 같이 추가해주면 된다.

Plug 'tpope/vim-surround'

Vim Peekaboo

레지스터 미리보기 기능을 제공한다. 이걸 설치해 두면 귀찮게 :reg를 입력하지 않아도 된다.

Vim에서는 내 사용방식과 잘 맞지 않아서 쓰지 않았는데, 묘하게 IntelliJ에서는 더 편리한 느낌이 있다.

다음과 같이 사용하면 된다.

set peekaboo

이후 NORMAL 모드에서 "를 입력하거나, INSERT 모드에서 <c-r>을 입력하면 IntelliJ 화면 왼쪽 아래쪽에 레지스터 미리보기가 나타난다.

소스코드

CommandOrMotion 찾기

프로젝트 루트에서 다음과 같이 @CommandOrMotion을 검색할 것.

grep -R @CommandOrMotion
rg @CommandOrMotion     # rg를 쓰는 편이 더 낫다

경험

2017-01-30 빌드 오류 해결

오래간만에 IdeaVIM Github에 가보니 Commit이 꽤 많아졌길래 별 생각 없이 pull을 했다.

git pull --rebase upstrem master

다음과 같이 빌드도 해 주었다.

./gradlew clean buildPlugin

그리고 IntelliJ에 들어가서 Install plugin from disk를 통해 빌드한 jar파일을 설치하려 했는데…

Error : Plugin 'IdeaVim' is incompatible with this installation라는 에러가 발생했다.

앗 뭐지. 온갖 삽질을 거친 끝에 @ideavim 트위터 계정에 물어보니 다음과 같은 응답을 받을 수 있었다.

@JohnGrib Current master branch is 2017.1+ due to platform API changes, check out branch platform-143 for 2016.1+.

대충 현재 master브랜치는 IntelliJ IDEA 2017.1+ 빌드를 위한 것이니까, 2016.1+ 빌드를 위한 platform-143브랜치로 체크아웃하면 된다는 것. 해보니 잘 된다. 역시 삽질부터 하지 말고 진작 공식 계정에 물어볼 걸 그랬다.

함께 읽기

  • [[/tool/jetbrains]]

주석