0Pricing
Lua Academy · 강의

명령과 키 매핑

사용자에게 제공할 동작을 추가해 보세요.

명령과 키 매핑은(는) CoddyKit의 무료 Lua Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Lua Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

사용자 명령 개요

사용자 명령은 플러그인이 :Format이나 :Telescope처럼 제공하는 콜론 명령입니다. 반드시 대문자로 시작해야 합니다.

nvim_create_user_command는 Lua에서 사용자 명령을 정의하며, 이름과 콜백 또는 문자열, 옵션 테이블을 받습니다. 이는 Vimscript의 :command를 대신합니다.

vim.api.nvim_create_user_command('Hello', function()
  print('Hello from my plugin')
end, {})

명령 인수

인수를 받으려면 nargs를 '0', '1', '*', '?', '+' 중 하나로 설정하십시오. 콜백은 args, fargs, bang을 포함한 opts 테이블을 받습니다.

fargs는 공백을 기준으로 이미 나뉜 인수 목록이므로, 일반적으로 원하는 형태입니다.

vim.api.nvim_create_user_command('Greet', function(opts)
  print('Hi ' .. opts.args)
end, { nargs = 1 })

범위 및 강제 실행 명령

행 범위를 받으려면 range = true를 전달하십시오. 그러면 콜백에서 opts.line1과 opts.line2를 읽을 수 있습니다. :Cmd!를 허용하려면 bang = true를 추가하고, opts.bang으로 이를 확인합니다.

이러한 플래그를 사용하면 하나의 명령이 시각적 선택 영역이나 강제 실행 변형에 따라 다르게 동작하도록 만들 수 있습니다.

vim.api.nvim_create_user_command('Sum', function(o)
  print(o.line1 .. ' to ' .. o.line2)
end, { range = true })

명령 완성

complete 옵션으로 탭 완성을 제공하십시오. 'file'이나 'buffer'와 같은 내장 기능 또는 사용자 지정 Lua 함수를 사용할 수 있습니다.

사용자 지정 완성 함수는 일부만 입력된 인수와 명령줄을 받아 후보 문자열 목록을 반환합니다.

vim.api.nvim_create_user_command('Pick', function(o) print(o.args) end, {
  nargs = 1,
  complete = function() return { 'red', 'green', 'blue' } end,
})

버퍼별 명령

명령의 범위를 하나의 버퍼로 제한하려면 버퍼 핸들과 함께 nvim_buf_create_user_command를 사용하십시오. 파일 형식 플러그인에서 흔히 사용하는 방식입니다.

예를 들어 Markdown 플러그인은 Markdown 버퍼 안에서만 :Preview를 정의하여 전역 이름 공간을 깔끔하게 유지할 수 있습니다.

vim.api.nvim_buf_create_user_command(0, 'Preview', function()
  print('previewing this buffer')
end, {})

vim.keymap.set 소개

vim.keymap.set은 최신 매핑 API입니다. 모드, 왼쪽 키, 오른쪽 문자열 또는 Lua 함수, 옵션 테이블을 받습니다.

이전의 nvim_set_keymap과 달리 오른쪽에 Lua 콜백을 직접 받을 수 있으므로 <cmd>lua로 감쌀 필요가 없습니다.

vim.keymap.set('n', '<leader>w', function()
  vim.cmd('write')
end, { desc = 'Save file' })

모드 및 여러 매핑

모드 인수는 'n'과 같은 단일 문자열일 수도 있고, 여러 모드에 한 번에 매핑하도록 { 'n', 'v' }와 같은 테이블일 수도 있습니다.

일반적인 모드는 다음과 같습니다. n은 일반 모드, i는 삽입 모드, v는 시각 모드, x는 시각 전용 모드, t는 터미널 모드입니다. 빈 문자열 ''은 일반 모드, 시각 모드, 연산자 대기 모드를 의미합니다.

vim.keymap.set({ 'n', 'v' }, '<leader>y', '"+y', { desc = 'Yank to clipboard' })

매핑 옵션

opts 테이블은 동작을 제어합니다. silent = true는 명령 에코를 표시하지 않게 하고, 안전을 위해 noremap은 기본적으로 true이며, buffer = 0은 현재 버퍼로 매핑 범위를 제한합니다.

which-key와 :map의 출력이 읽기 쉽게 유지되도록 항상 desc를 추가하십시오.

vim.keymap.set('n', 'gd', vim.lsp.buf.definition, {
  buffer = 0, silent = true, desc = 'Go to definition',
})

표현식 매핑

expr = true로 설정하면 오른쪽 함수가 입력으로 전달할 키를 반환합니다. 이를 사용하면 완성 메뉴가 표시되어 있을 때 <Tab>의 동작을 다르게 만드는 것과 같은 지능적인 매핑을 구현할 수 있습니다.

아무 작업도 하지 않으려면 빈 문자열을 반환하고, 삽입할 키는 해당 키를 그대로 반환하십시오.

vim.keymap.set('i', '<Tab>', function()
  return vim.fn.pumvisible() == 1 and '<C-n>' or '<Tab>'
end, { expr = true })

매핑 삭제

vim.keymap.del에 같은 모드와 키를 전달하여 매핑을 제거하십시오. 버퍼별 매핑이었다면 buffer 필드도 전달해야 합니다.

정리 루틴에서 사용하거나, 플러그인이 기능을 끄면서 사용자의 원래 키 바인딩을 복원해야 할 때 유용합니다.

vim.keymap.del('n', '<leader>w')
vim.keymap.del('n', 'gd', { buffer = 0 })

명령과 키 매핑 함께 사용하기

깔끔한 패턴은 로직을 한 번만 정의하고, 이를 사용자 명령으로 노출한 다음, 해당 명령을 호출하는 키를 연결하는 것입니다. 이렇게 하면 단일 진실 공급원을 유지할 수 있습니다.

<cmd>Hello<cr>에 매핑하면 시각 모드를 벗어나지 않으므로 :Hello<cr>보다 예측 가능하게 동작합니다.

vim.api.nvim_create_user_command('Toggle', function() end, {})
vim.keymap.set('n', '<leader>t', '<cmd>Toggle<cr>', { desc = 'Toggle' })

빠른 점검

명령과 키 매핑에 대한 이해도를 확인해 보십시오.

복습: 명령과 키 매핑

이제 nvim_create_user_command로 명령을 만들고, nargs, range, bang, complete로 명령을 제어하며, 버퍼별로 범위를 지정할 수 있습니다.

매핑에서는 vim.keymap.set으로 Lua 콜백, 여러 모드, desc, silent, buffer, expr와 같은 옵션을 사용할 수 있으며, 정리할 때는 vim.keymap.del을 사용합니다.

자주 묻는 질문

“명령과 키 매핑” 강의는 무료인가요?

네 — “명령과 키 매핑” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Lua Academy 강의 전체를 잠금 해제할 수 있습니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“명령과 키 매핑”에서 뭘 배우나요?

사용자에게 제공할 동작을 추가해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Lua Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Lua Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Lua Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“명령과 키 매핑” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Lua Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Lua Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Neovim Lua API
  2. 명령과 키 매핑
  3. 버퍼와 창
  4. 플러그인 패키징하기
← Lua Academy(으)로 돌아가기