KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

kickstart.nvim

★ 31,279 Open GitHub ↗

개인용 nvim 설정을 위한 시작점

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# kickstart.nvim
## Introduction
다음 특징을 가진 Neovim 시작점:
\* 작음
\* 단일 파일
\* 완벽한 문서화
Neovim 배포판이 \*\*아니며\*, 사용자의 설정을 시작하기 위한 기반입니다.
## Installation
### Install Neovim
Kickstart.nvim은 Neovim의 최신
['stable'](https://github.com/neovim/neovim/releases/tag/stable) 및 최신
['nightly'](https://github.com/neovim/neovim/releases/tag/nightly) 버전\*만\* 지원합니다.
문제가 발생한다면 최소한 최신 stable 버전을 사용하고 있는지 확인해 주세요. 대개의 경우 [패키지 관리자](https://github.com/neovim/neovim/blob/master/INSTALL.md#install-from-package)를 통해 neovim을 설치하는 것을 권장합니다.
Neovim 버전을 확인하려면 `nvim --version`을 실행하고 최신
['stable'](https://github.com/neovim/neovim/releases/tag/stable) 버전보다 낮지 않은지 확인하세요. 선택한 설치 방법으로 구버전의 neovim만 설치된다면, [아래의 대안 설치 방법](#alternative-neovim-installation-methods)을 참고하세요.
### Install External Dependencies
외부 필수 요구사항:
- 기본 유틸리티: `git`, `make`, `unzip`, C 컴파일러 (`gcc`)
- [ripgrep](https://github.com/BurntSushi/ripgrep#installation),
[fd-find](https://github.com/sharkdp/fd#installation)
- [tree-sitter CLI](https://github.com/tree-sitter/tree-sitter/blob/master/crates/cli/README.md#installation)
- 클립보드 도구 (플랫폼에 따라 xclip/xsel/win32yank 등)
- [Nerd Font](https://www.nerdfonts.com/): 선택 사항, 다양한 아이콘 제공
- 설치되어 있다면 `init.lua`에서 `vim.g.have\_nerd\_font`를 true로 설정하세요.
- 이모지 폰트 (Ubuntu 전용이며, 이모지를 원하는 경우에만 해당): `sudo apt install fonts-noto-color-emoji`
- 언어 설정:
- Typescript를 작성하려면 `npm`이 필요합니다.
- Golang을 작성하려면 `go`가 필요합니다.
- 기타 등등.
> [!NOTE]
> Windows 및 Linux 전용 추가 참고 사항과 빠른 설치 스니펫은 [Install Recipes](#Install-Recipes)를 참조하세요.
### Install Kickstart
> [!NOTE]
> 이전 설정이 있는 경우 [백업](#FAQ)하세요.
Neovim 설정 파일은 운영체제에 따라 다음 경로에 위치합니다:
| OS | PATH |
| :- | :--- |
| Linux, MacOS | `$XDG\_CONFIG\_HOME/nvim`, `~/.config/nvim` |
| Windows (cmd)| `%localappdata%\nvim\` |
| Windows (powershell)| `$env:LOCALAPPDATA\nvim\` |
#### Recommended Step
GitHub의 ["Use this template"](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template) 버튼을 사용하여 이 저장소의 나만의 복사본을 만드세요. 이를 통해 수정할 수 있는 자신만의 저장소를 갖게 되며, 운영체제에 맞춰 아래 명령어 중 하나를 사용하여 새로 만든 저장소를 내 컴퓨터에 클론하여 설치할 수 있습니다.
또는 쉬운 업스트림 동기화 경로를 선호하는 경우(예: 별도의 브랜치에 설정을 유지하고 업스트림에서 `master`로 fast-forward 하는 방식) 이 저장소를 [fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo)할 수도 있습니다. 두 접근 방식 간의 장단점에 대해서는 [#1740 토론](https://github.com/nvim-lua/kickstart.nvim/issues/1740)을 참고하세요.
> [!NOTE]
> 저장소 URL은 다음과 같은 형태가 됩니다:
> `https://github.com//kickstart.nvim.git`
저장소의 `.gitignore` 파일에서도 `nvim-pack-lock.json`을 제거하는 것이 좋습니다. 유지보수를 더 쉽게 하기 위해 kickstart 저장소에서는 무시되도록 설정되어 있지만, 버전 관리에서 추적하는 것이 권장됩니다(`:help vim.pack-lockfile` 참고).
#### Clone kickstart.nvim
> [!NOTE]
> 위의 권장 단계(템플릿이나 fork를 사용하여 자신만의 저장소를 생성하는 것)를 따르는 경우, 아래 명령어의 `nvim-lua`를 ``로 교체하세요.
 Linux and Mac 
```sh
git clone https://github.com/nvim-lua/kickstart.nvim.git "${XDG\_CONFIG\_HOME:-$HOME/.config}"/nvim
```
 Windows 
`cmd.exe`를 사용하는 경우:
```
git clone https://github.com/nvim-lua/kickstart.nvim.git "%localappdata%\nvim"
```
`powershell.exe`를 사용하는 경우:
```
git clone https://github.com/nvim-lua/kickstart.nvim.git "${env:LOCALAPPDATA}\nvim"
```
### Post Installation
Neovim 시작하기
```sh
nvim
```
이게 전부입니다! `vim.p

ack`은 설정의 모든 플러그인을 설치합니다. 플러그인 상태를 확인하려면
`:lua vim.pack.update(nil, { offline = true })`를 사용하고,
업데이트를 가져오려면 `:lua vim.pack.update()`를 사용하세요(`:write`는 업데이트를 적용하고, `:quit`은
취소합니다).
#### 친절한 문서 읽기 (Read The Friendly Documentation)
Neovim 확장 및 탐색에 대한 자세한 내용을 보려면
설정 폴더의 `init.lua` 파일을 읽어보세요. 여기에는 널리 요청되는 플러그인 추가 예제도 포함되어 있습니다.
> [!NOTE]
> 특정 플러그인에 대한 자세한 내용은 해당 저장소의 문서를 확인하세요.
### 시작하기 (Getting Started)
[Neovim 시작하기 위해 시청해야 할 유일한 영상](https://youtu.be/m8C0Cq9Uv9o)
### FAQ
\* 이미 기존 Neovim 설정이 있는 경우 어떻게 해야 하나요?
\* 백업한 후 관련된 모든 파일을 삭제해야 합니다.
\* 여기에는 기존 init.lua와 `rm -rf ~/.local/share/nvim/`을 사용하여 삭제할 수 있는
`~/.local` 내의 Neovim 파일들이 포함됩니다.
\* kickstart와 병행하여 기존 설정을 유지할 수 있나요?
\* 네! [NVIM\_APPNAME](https://neovim.io/doc/user/starting.html#%24NVIM\_APPNAME)`=nvim-NAME`을 사용하여
여러 설정을 유지할 수 있습니다. 예를 들어, `~/.config/nvim-kickstart`에 kickstart
설정을 설치하고 다음과 같이 별칭(alias)을 생성할 수 있습니다:
```
alias nvim-kickstart='NV_APPNAME="nvim-kickstart" nvim'
```
`nvim-kickstart` 별칭을 사용하여 Neovim을 실행하면 대체
설정 디렉토리와 일치하는 로컬 디렉토리인
`~/.local/share/nvim-kickstart`를 사용하게 됩니다. 이 접근 방식은 사용해보고 싶은 모든 Neovim
배포판에 적용할 수 있습니다.
\* 이 설정을 "제거(uninstall)"하려면 어떻게 해야 하나요?
\* 설정 디렉토리와 로컬 데이터 디렉토리를 제거합니다(예:
`~/.config/nvim` 및 `~/.local/share/nvim`).
\* 왜 kickstart의 `init.lua`는 단일 파일인가요? 여러 파일로 나누는 것이 더 합리적이지 않나요?
\* kickstart의 주요 목적은 교육용 도구이자, 누구나 자신의 설정을 위한 기반으로 `git clone`하여 쉽게 사용할 수 있는
참조 설정의 역할을 하는 것입니다. Neovim과 Lua 학습이 진행됨에 따라 `init.lua`를
더 작은 부품으로 나누는 것을 고려해 볼 수 있습니다. 동일한 기능을 유지하면서 이를 수행하는 kickstart의 포크 버전은 다음에서 확인할 수 있습니다:
\* [kickstart-modular.nvim](https://github.com/dam9000/kickstart-modular.nvim)
\* 이 주제에 대한 토론은 다음에서 찾을 수 있습니다:
\* [설정 재구조화 (Restructure the configuration)](https://github.com/nvim-lua/kickstart.nvim/issues/218)
\* [init.lua를 다중 파일 구조로 재구성 (Reorganize init.lua into a multi-file setup)](https://github.com/nvim-lua/kickstart.nvim/pull/473)
### 설치 가이드 (Install Recipes)
아래에서 Neovim 및 종속성에 대한 OS별 설치 지침을 확인할 수 있습니다.
모든 종속성을 설치한 후 [Install Kickstart](#install-kickstart) 단계로 진행하세요.
#### Windows 설치
Microsoft C++ Build Tools 및 CMake를 사용하는 Windows
Kickstart의 기본 설정은 `telescope-fzf-native.nvim`에 대해 make 전용입니다.
`make`를 사용할 수 없는 경우, 해당 플러그인은 건너뜁니다.
권장 사항: `make`를 설치하세요(아래 chocolatey 섹션 참조).
CMake 전용 설정을 원하시는 경우, 두 곳에서 `init.lua`를 커스텀하세요:
1. `cmake`를 사용할 수 있을 때 `telescope-fzf-native.nvim`을 포함합니다:
```lua
if vim.fn.executable 'make' == 1 or vim.fn.executable 'cmake' == 1 then
table.insert(plugins, gh 'nvim-telescope/telescope-fzf-native.nvim')
end
```
2. `PackChanged` 훅에서, `make`를 사용할 수 없을 때 CMake를 사용합니다:
```lua
if name == 'telescope-fzf-native.nvim' then
if vim.fn.executable 'make' == 1 then
run_build(name, { 'make' }, ev.data.path)
elseif vim.fn.executable 'cmake' == 1 then
run_build(name, { 'cmake', '-S.', '-Bbuild', '-DCMAKE_BUILD_TYPE=Release' }, ev.data.path)
run_build(name, { 'cmake', '--build', 'build', '--config', 'Release', '--target', 'install' }, ev.data.path)
end
return
end
```
[빌드 세부 정보](https://github.com/nvim-telescope/telescope-fzf-native.nvim#installation)는 `telescope-fzf-native` 문서를 참조하세요.
chocolatey를 사용하여 gcc/make를 사용하는 Windows
또는 설정을 변경할 필요가 없는 gcc와 make를 설치할 수도 있습니다.

가장 쉬운 방법은 choco를 사용하는 것입니다:
1. [chocolatey](https://chocolatey.org/install)를 설치합니다.
페이지의 지침을 따르거나 winget을 사용하고,
cmd를 \*\*관리자 권한\*\*으로 실행하여 다음을 입력합니다:
```
winget install --accept-source-agreements chocolatey.chocolatey
```
2. choco를 사용하여 모든 필수 요소를 설치합니다. 이전 cmd 창을 닫고
새 창을 열어 choco 경로가 설정되도록 한 뒤, cmd를 \*\*관리자 권한\*\*으로 실행하여 다음을 입력합니다:
```
choco install -y neovim git ripgrep wget fd unzip gzip mingw make tree-sitter
```
WSL (Windows Subsystem for Linux)
```
wsl --install
wsl
sudo add-apt-repository ppa:neovim-ppa/unstable -y
sudo apt update
sudo apt install make gcc ripgrep fd-find tree-sitter-cli unzip git xclip neovim
```
#### Linux 설치
Ubuntu 설치 단계
```
sudo add-apt-repository ppa:neovim-ppa/unstable -y
sudo apt update
sudo apt install make gcc ripgrep fd-find tree-sitter-cli unzip git xclip neovim
```
Debian 설치 단계
```
sudo apt update
sudo apt install make gcc ripgrep fd-find tree-sitter-cli unzip git xclip curl
# Now we install nvim
curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86\_64.tar.gz
sudo rm -rf /opt/nvim-linux-x86\_64
sudo mkdir -p /opt/nvim-linux-x86\_64
sudo chmod a+rX /opt/nvim-linux-x86\_64
sudo tar -C /opt -xzf nvim-linux-x86\_64.tar.gz
# make it available in /usr/local/bin, distro installs to /usr/bin
sudo ln -sf /opt/nvim-linux-x86\_64/bin/nvim /usr/local/bin/
```
Fedora 설치 단계
```
sudo dnf install -y gcc make git ripgrep fd-find tree-sitter-cli unzip neovim
```
Arch 설치 단계
```
sudo pacman -S --noconfirm --needed gcc make git ripgrep fd tree-sitter-cli unzip neovim
```
### 대안적인 Neovim 설치 방법
일부 시스템에서는 Neovim이 권장하는 [패키지 매니저 설치 방법](https://github.com/neovim/neovim/blob/master/INSTALL.md#install-from-package)의 버전이 크게 뒤처져 있는 경우가 종종 있습니다. 이 경우,
최신 Neovim 버전을 매우 빠르게 제공하는 것으로 알려진 다음 방법 중 하나를 선택하세요.
이 방법들은 대중성이 높고 최신 버전의 Neovim을 쉽고 간단하게 설치 및 업데이트할 수 있기 때문에 선택되었습니다.
사용 가능한 방법에 대해 논의된 더 자세한 내용은 [여기](https://github.com/nvim-lua/kickstart.nvim/issues/1583)에서 확인할 수 있습니다.
Bob
[Bob](https://github.com/MordechaiHadad/bob)은 모든 플랫폼을 위한 Neovim 버전 관리자입니다. 간단히
[rustup](https://rust-lang.github.io/rustup/installation/other.html)을 설치하고,
다음 명령어를 실행하세요:
```bash
rustup default stable
rustup update stable
cargo install bob-nvim
bob use stable
```
Homebrew
[Homebrew](https://brew.sh)는 Mac과 Linux에서 인기 있는 패키지 매니저입니다.
[`brew install`](https://formulae.brew.sh/formula/neovim)을 사용하여 간단히 설치하세요.
Flatpak
Flatpak은 개발자가 애플리케이션을 단 한 번만 패키징하여 모든 Linux 시스템에서 사용할 수 있도록 해주는 애플리케이션 패키지 매니저입니다. [flatpak을 설치](https://flatpak.org/setup/)하고
[flathub](https://flathub.org/setup)을 설정한 뒤 [Neovim을 설치](https://flathub.org/apps/io.neovim.nvim)하면 됩니다.
asdf 및 mise-en-place
[asdf](https://asdf-vm.com/)와 [mise](https://mise.jdx.dev/)는 주로 프로젝트별 도구 버전을 관리하기 위한 도구 버전 관리자입니다. 그러나 두 도구 모두 사용자 공간에서 전역적으로 도구를 관리하는 기능도 지원합니다:
mise
[mise 설치](https://mise.jdx.dev/getting-started.html) 후, 다음을 실행하세요:
```bash
mise plugins install neovim
mise use neovim@stable
```
asdf
[asdf 설치](https://asdf-vm.com/guide/getting-started.html) 후, 다음을 실행하세요:
```bash
asdf plugin add neovim
asdf install neovim stable
asdf set neovim stable --home
asdf reshim neovim
```

kickstart.nvim

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README