# 🏗️ Capstone: đóng gói cấu hình Neovim cho công việc thật

By 3T1C

> This lesson is premium content. Sign in and purchase the course to view the full content.

Buổi trước bạn đã dọn xong đám lỗi Windows 11: shell mặc định, đường dẫn có dấu cách, provider Python/Node, clipboard. Giờ không còn gì để "chữa cháy" nữa. Việc còn lại là biến đống config đang chạy được thành một **sản phẩm**: cấu trúc rõ ràng, có Git, có ghi chú, và tự bạn mở rộng được về sau mà không cần hỏi ai.

Đây là bài capstone, nên mentor sẽ không đưa config mẫu để copy. Mình đưa đặc tả và tiêu chí nghiệm thu, bạn tự lắp từ những mảnh đã học ở module 1 và 2.

## Đích đến: một cấu hình sống được qua nhiều máy

Mục tiêu cụ thể: sau buổi này, bạn có một thư mục `nvim` được quản lý bằng Git, clone sang máy Windows khác là chạy được trong vài phút, và có một file ghi chú đủ để 3 tháng sau bạn tự thêm plugin mới mà không phải đọc lại toàn bộ config.

Tiêu chí quan trọng hơn cả: **cấu hình phải nông, không sâu**. Nghĩa là mỗi file làm đúng một việc, một plugin chỉ xuất hiện vì bạn thực sự dùng nó hằng ngày.

## Bản đặc tả: cấu hình của bạn phải có gì

Cấu trúc đích (đường dẫn trên Windows 11):

```tree
~/AppData/Local/nvim/
  init.lua
  lua/
    config/
      options.lua
      keymaps.lua
      autocmds.lua
      lazy.lua
    plugins/
      lsp.lua
      telescope.lua
      treesitter.lua
      git.lua
  lazy-lock.json
  README.md
  NOTES.md
```

Yêu cầu bắt buộc:

- `init.lua` mỏng, chỉ set leader rồi `require` các module `config.*`. Không nhồi option vào đây.
- `lua/plugins/*.lua` chia theo **mảng chức năng**, mỗi file `return` một table spec cho lazy.nvim.
- Toàn bộ keymap của bạn nằm trong `keymaps.lua`, nhóm theo prefix có `desc` rõ ràng.
- `lazy-lock.json` được commit. Thư mục dữ liệu plugin (`~/AppData/Local/nvim-data`) thì **không** commit.
- `README.md` ghi cách cài trên máy mới. `NOTES.md` ghi các lỗi Windows đã gặp và cách xử lý.

## In this lesson

- Lộ trình 5 chặng để đóng gói
- Nghiệm thu: khi nào thì coi là xong
- Bẫy thường gặp khi đóng gói


---

## Contents

Part of [🛠️ Config neovim trên win 11](https://everwise.study/courses/config-neovim-tren-win-11.md)

- **🧱 Nền tảng cấu hình bằng Lua và plugin manager**
  - [📁 Bộ khung init.lua và cách tổ chức file cấu hình trên Windows 11](https://everwise.study/courses/config-neovim-tren-win-11/bo-khung-init-lua-tren-windows-11.md)
  - [📦 Quản lý plugin với lazy.nvim và hướng mở rộng với vim.pack](https://everwise.study/courses/config-neovim-tren-win-11/quan-ly-plugin-lazy-nvim-va-vim-pack.md) (sign-in required)
  - [⌨️ Keybinding, leader key và workflow làm việc hiệu quả](https://everwise.study/courses/config-neovim-tren-win-11/keybinding-leader-key-va-workflow.md)
  - [✅ Checkpoint: Nền tảng cấu hình Lua và plugin manager](https://everwise.study/courses/config-neovim-tren-win-11/checkpoint-nen-tang-cau-hinh-lua.md)
- **🧠 Đưa Neovim lên mức IDE: LSP, Telescope, Treesitter**
  - [🔍 LSP, autocomplete và diagnostics](https://everwise.study/courses/config-neovim-tren-win-11/lsp-autocomplete-va-diagnostics.md)
  - [🔭 Telescope: tìm file và grep trong dự án](https://everwise.study/courses/config-neovim-tren-win-11/telescope-tim-file-va-grep.md)
  - [🌳 Treesitter: cú pháp, highlight và folding](https://everwise.study/courses/config-neovim-tren-win-11/treesitter-cu-phap-va-folding.md)
  - [✅ Checkpoint: LSP, Telescope và Treesitter](https://everwise.study/courses/config-neovim-tren-win-11/checkpoint-lsp-telescope-treesitter.md)
- **🚀 Capstone: cấu hình hoàn chỉnh dùng cho công việc thật**
  - [🌿 Tích hợp Git và terminal trong Neovim](https://everwise.study/courses/config-neovim-tren-win-11/tich-hop-git-va-terminal.md)
  - [🩺 Khắc phục lỗi đặc thù trên Windows 11](https://everwise.study/courses/config-neovim-tren-win-11/khac-phuc-loi-dac-thu-tren-windows-11.md)
  - [🏗️ Capstone: đóng gói cấu hình Neovim cho công việc thật](https://everwise.study/courses/config-neovim-tren-win-11/capstone-dong-goi-cau-hinh-neovim.md) (premium content) — this lesson
  - [✅ Checkpoint: Capstone và xử lý sự cố trên Windows](https://everwise.study/courses/config-neovim-tren-win-11/checkpoint-capstone-windows.md) (premium content)
- [Course cheatsheet](https://everwise.study/courses/config-neovim-tren-win-11/cheatsheet.md) (premium content)