AstroNvim User Configuration Example

A user configuration template for AstroNvim

🛠️ Installation

Make a backup of your current nvim and shared folder

mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak

Create a new user repository from this template

Press the "Use this template" button above to create a new repository to store your user configuration.

You can also just clone this repository directly if you do not want to track your user configuration in GitHub.

Clone the repository

git clone https://github.com/1538379200/astronvim-config-v4.git ~/.config/nvim/lua/user

windows使用

git clone https://github.com/1538379200/astronvim-config-v4.git $env:LOCALAPPDATA\nvim\lua\user

Start Neovim

nvim

可能需要的环境配置

pack 包大多是以 community 的方式加入的，如果你不需要，可以在 community 文件中注释

• node.js

• ripgrep

• 目标编程语言（从 commnunity 的 pack 查找对应语言去安装）

• markmap（npm install -g markmap-cli）

• code-minimap（使用小地图 code-minimap 会需要）

• fd （python 的 envselect 插件需要使用工具

rust-analyzer配置

进行 rust 项目时，你还需要加入 rust-analyzer 组件，之后才能通过其进行代码提示等操作

rustup compnent add rust-analyzer

修改快捷键

astronvim 默认映射：https://astronvim.com/Basic%20Usage/mappings

• s ：flask插件文字搜索 -- normal

• Alt + j/k：函数间上下跳转 -- normal

• Alt + h/l：跳转左右标签（buffer）-- normal

• Ctrl + j/k/h/l：插入模式下光标移动 -- insert

• <leader>Tl：TODO列表 -- normal

• <leader>Tq：TODO快速修复 -- normal

• F7：水平方向打开 toggleterm -- normal

• Ctrl+\：同 F7 相同的 terminal 窗口，使用 Ctrl+\ 然后使用 Ctrl+n 可回到normal模式（当前已设置，可以直接使用 ESC 来返回普通模式，也可以直接使用 Ctrl+w 切换窗口，如 Ctrl+w+l），normal模式下可以使用 Ctrl+\ 或 Ctrl+j/k 或 F7 切换到编辑器中 --normal

• Shift+F7 ：打开外部的 ternimal，仅windows有效，默认 pwsh -- normal

  • 默认会先查找 pwsh 命令是否存在，如果存在，则使用 pwsh 命令（PowerShell 7），如果不存在，则打开的为 cmd 窗口
  • 进入 polish.lua 文件中，可以填写固定的 terminal 配置

• <leader>E：快速在当前文件位置打开系统文件管理器，仅在 windows 中有效 -- normal

• Ctrl+Shift+F10：运行代码/预览markdown等 -- normal

• Ctrl+F12：侧边栏展示页面中所有函数变量等（aerial） -- normal

• F12：使用 telescope 打开 aerial -- normal

  • <Enter>：跳转
  • q：关闭

• <leader>a：选择生成不同的注释结构（可以使用 luasnip 的跳转功能）-- normal

  • 常用如：<leader>af，为当前函数生成注释

• Tab：

  • 在 luasnip 片段中，并且当前属于 insert 模式，tab跳转下一个编辑，shift+tab 为跳转上一个编辑处 -- normal

• Shift+Enter ：普通模式下增加一行 -- normal

• Ctrl+s：插入和普通模式强制保存 -- normal, insert

• ]e：跳转到下一个错误，[e 跳转上一个错误 -- normal

• ]d, [d: 同上，]e 已改成 ]d 的形式

• ]t/[t：上一个和下一个 todo 标记 -- normal

• <leader>I：lspsaga 的 incoming_calls ，查看谁调用了此方法函数 -- normal

• <leader>O：lspsaga 的 outgoing_calls ，查看此函数使用了那些方法 -- normal

  • <Enter>：打开文件，跳转
  • |：垂直分屏
  • \：水平分屏
  • t：tab形式打开
  • q：退出
  • <C-c>k：关闭
  • <C-l>：在窗口间切换

• K 显示文档，再点击一次 K 进入弹窗，移动到链接，使用 gx 前往链接地址 -- normal

• <leader>fG ：使用 telescope 增加参数过滤 --normal：

  • "test" testcases ：搜索 testcases 目录下的 test 字符
  • "test" --iglob **/test_child/** ：搜索所有 test_child 目录下文件中的 test 字符
  • "test" -g "*.py" ：过滤文件格式
  • 依赖于 ripgrep 的过滤，可以参考ripgrep/GUIDE.md at master · BurntSushi/ripgrep (github.com)

• <leader>ZM ：开始禅模式，ZenMode，更纯净的代码编写模式 - normal

• Ctrl+Shift+F10：快速运行当前文件（仅适用 windows 本地 环境） -- normal

  • python文件会自动设置临时 PYTHONPATH ，并运行当前文件
  • golang则使用 go run .
  • markdown使用MarkdownPreview 预览
  • rust使用 cargo run. 运行

• Ctrl+Shift+Alt+F10：使用外部命令行工具运行文件 -- normal

  • 如果安装了 PowerShell 7 的工具，能使用 pwsh 调用命令，则会优先使用 pwsh 命令
  • 仅在 Windows 中生效

• F10 ：打开/关闭 Overseer 插件任务管理窗口 - normal

• <leader>fy：查找复制的文本，也可以使用 Win+v 拿windows的系统粘贴板，因为vim的寄存器和系统粘贴板是互通的，但是插件是没有系统粘贴板的历史内容的

  • 使用 <enter> 直接粘贴
  • 普通模式使用 d 删除，输入模式使用 ctrl+d 删除
  • 编辑普通模式使用 e ，输入模式使用 ctrl+e

• <leader>Rl：重启 LSP 服务，后续 <leader>R 前缀的将都作为重启/刷新某服务的前缀

• F5：打开 mundo 窗口，显示文件差异，可进行撤销等操作 -- normal：

  • p ：可以在下方小窗口演示差异变化，使用 r 恢复
  • P ：在文件中显示当前节点的状态
  • <enter> ：选择当前节点，撤回到此节点的状态

• Ctrl+k ：插入模式下，快速将当前行切换到中间，相当于普通模式下 zz -- normal

• ga ：插件 EasyAlign 快捷方式，选中可使用例如 ga= 对齐 = 前后，常用 vipga= -- n, x, v

• <leader>um：插件 code-minimap 切换按键，code-minimap 需要安装软件才可以使用

• lspsaga 常用快捷键：

  • <leader>la：code_action
  • <leader>lS: outline
  • <leader>lc: incoming_calls
  • <leader>lC: outgoing_calls
  • <leader>R: search references

• <leader>s: 进行搜索替换 -- normal