MoranisZ

I love you, like a pulse, like something hidden, like breathing.

Announcement

Welcome to my blog! This is a sample announcement.

Learn More

960 words

5 minutes

LazyVim安装与初步配置

2025-10-28

Usage Of Arch Linux

ArchLinux

/

Nvim

/

Linux，LazyVim

Lazyvim安装与初步配置#

1. 安装 LazyVim#

确保已经安装了 Neovim。然后按照以下步骤安装 LazyVim：

1
# 备份现有的 Neovim 配置（如果有）
2
mv ~/.config/nvim ~/.config/nvim.bak
3
mv ~/.local/share/nvim ~/.local/share/nvim.bak
4

5
# 克隆 LazyVim 启动模板
6
git clone https://github.com/LazyVim/starter ~/.config/nvim

启动 Neovim，LazyVim 会自动安装插件管理器和默认插件。

2. 配置 LazyVim#

LazyVim 的配置文件位于 ~/.config/nvim/lua/config/ 和 ~/.config/nvim/lua/plugins/。需要修改以下文件：（没有则创建）

2.1 基本配置 (`lua/config/options.lua`)#

确保启用语法高亮和一些基本设置。编辑 lua/config/options.lua，添加或确认以下内容：

1
vim.opt.syntax = "on" -- 启用语法高亮
2
vim.opt.number = true -- 显示行号
3
vim.opt.relativenumber = true -- 相对行号
4
vim.opt.tabstop = 2 -- Tab 宽度
5
vim.opt.shiftwidth = 2 -- 缩进宽度
6
vim.opt.expandtab = true -- Tab 转空格
7
vim.opt.smartindent = true -- 智能缩进
8
vim.opt.termguicolors = true -- 启用真彩色（好看主题需要）

2.2 代码提示和检查（LSP 配置）#

通过 nvim-lspconfig 和 mason.nvim 提供代码提示和检查功能。需要安装语言服务器并配置插件。

编辑 lua/plugins/lsp.lua，添加以下内容（或在默认配置基础上扩展）：

1
return {
2
  {
3
    "neovim/nvim-lspconfig",
4
    config = function()
5
      local lspconfig = require("lspconfig")
6
      -- 示例：配置 Python 和 JavaScript 的 LSP
7
      lspconfig.pyright.setup {} -- Python
8
      lspconfig.tsserver.setup {} -- JavaScript/TypeScript
9
      lspconfig.lua_ls.setup {} -- Lua
10
    end,
11
  },
12
  {
13
    "williamboman/mason.nvim",
14
    opts = {
15
      ensure_installed = {
16
        "pyright", -- Python LSP
17
        "tsserver", -- JavaScript/TypeScript LSP
18
        "lua_ls", -- Lua LSP
19
        -- 根据需要添加其他语言的 LSP
20
      },
21
    },
22
  },
23
  {
24
    "hrsh7th/nvim-cmp",
25
    dependencies = {
26
      "hrsh7th/cmp-nvim-lsp",
27
      "hrsh7th/cmp-buffer",
28
      "hrsh7th/cmp-path",
29
      "L3MON4D3/LuaSnip",
30
    },
31
    config = function()
32
      local cmp = require("cmp")
33
      cmp.setup({
34
        snippet = {
35
          expand = function(args)
36
            require("luasnip").lsp_expand(args.body)
37
          end,
38
        },
39
        mapping = cmp.mapping.preset.insert({
40
          ["<C-b>"] = cmp.mapping.scroll_docs(-4),
41
          ["<C-f>"] = cmp.mapping.scroll_docs(4),
42
          ["<C-Space>"] = cmp.mapping.complete(),
43
          ["<C-e>"] = cmp.mapping.abort(),
44
          ["<CR>"] = cmp.mapping.confirm({ select = true }),
45
        }),
46
        sources = cmp.config.sources({
47
          { name = "nvim_lsp" },
48
          { name = "luasnip" },
49
          { name = "buffer" },
50
          { name = "path" },
51
        }),
52
      })
53
    end,
54
  },
55
}

启动 Neovim，Mason 会自动安装配置的语言服务器。代码提示通过 nvim-cmp 实现，支持自动补全、函数签名等。

2.3 语法高亮#

编辑 lua/plugins/treesitter.lua，确保安装所需的语言解析器：

1
return {
2
  {
3
    "nvim-treesitter/nvim-treesitter",
4
    build = ":TSUpdate",
5
    config = function()
6
      require("nvim-treesitter.configs").setup({
7
        ensure_installed = {
8
          "python",
9
          "javascript",
10
          "typescript",
11
          "lua",
12
          "html",
13
          "css",
14
          "json",
15
          "markdown",
16
          -- 根据需要添加其他语言
17
        },
18
        highlight = { enable = true }, -- 启用语法高亮
19
        indent = { enable = true }, -- 启用自动缩进
20
      })
21
    end,
22
  },
23
}

运行 :TSUpdate 确保 Treesitter 解析器是最新的。

2.4 好看的主题#

LazyVim 默认提供多种主题，可以选择一个好看的主题。

1
return {
2
  {
3
    "catppuccin/nvim",
4
    name = "catppuccin",
5
    priority = 1000,
6
    config = function()
7
      vim.cmd([[colorscheme catppuccin]])
8
    end,
9
  },
10
  -- 可选：其他主题
11
  -- { "folke/tokyonight.nvim", config = function() vim.cmd([[colorscheme to 😂kyonight]]) end },
12
}

推荐主题：

Catppuccin：柔和、现代化，支持多种风格（latte、frappe、macchiato、mocha）。
TokyoNight：深色主题，科技感强。
Dracula：经典暗色主题。

安装后，使用 :colorscheme catppuccin 切换主题。

3. 额外推荐插件#

为了增强体验，可以添加以下插件到 lua/plugins/extra.lua：

1
return {
2
  -- 文件浏览器
3
  {
4
    "nvim-neo-tree/neo-tree.nvim",
5
    branch = "v3.x",
6
    dependencies = {
7
      "nvim-lua/plenary.nvim",
8
      "nvim-tree/nvim-web-devicons",
9
      "MunifTanjim/nui.nvim",
10
    },
11
    config = function()
12
      require("neo-tree").setup()
13
    end,
14
  },
15
  -- 状态栏美化
16
  {
17
    "nvim-lualine/lualine.nvim",
18
    config = function()
19
      require("lualine").setup({
20
        options = { theme = "catppuccin" }, -- 与主题匹配
21
      })
22
    end,
23
  },
24
}

4. 同步插件#

保存所有配置文件后，启动 Neovim，运行以下命令：

1
:Lazy

这会打开 Lazy.nvim 插件管理器，自动安装和同步所有插件。

5. 测试与使用#

代码提示：在支持的语言文件中输入代码，按 <C-Space> 触发补全。
代码检查：LSP 会自动检测错误并显示诊断信息（悬浮提示用 K 键）。
语法高亮：Treesitter 确保代码高亮准确且美观。
主题：通过 :colorscheme 命令切换主题，或在配置文件中固定。

6. 常见问题#

LSP 不工作？
- 确保 Mason 安装了正确的语言服务器（:Mason 查看）。
- 检查网络连接，部分语言服务器需要下载。
主题不好看？
- 确保终端支持真彩色（echo $TERM 应为 xterm-256color 或类似）。
- 尝试其他主题，如 tokyonight 或 dracula。

7. 扩展阅读#

LazyVim 官方文档：https://www.lazyvim.org/
Neovim LSP 配置：https://github.com/neovim/nvim-lspconfig
Treesitter 插件：https://github.com/nvim-treesitter/nvim-treesitter
Catppuccin 主题：https://github.com/catppuccin/nvim

LazyVim安装与初步配置

https://paradoxmoranis.github.io/posts/lazyvim安装与初步配置/

Author

MoranisZ

Published at

2025-10-28

License

CC BY-NC-SA 4.0

ClaudeCode使用西风API

开发过程中常用的软件和我平时使用的软件

Moranis Love you!