Arch Linux下打开Neovim时ast-grep LSP报错的原因及解决方法

开发者阿泽

2026-6-27

ast-grep LSP报错：Cannot read configuration.. No such file or directory (os error 2) 解析与解决

报错含义

这个错误表示ast-grep LSP启动时找不到所需的配置文件，os error 2是系统层面的「文件或目录不存在」错误。ast-grep依赖.ast-grep.yml或sgconfig.yml这类配置文件加载规则，找不到该文件就会触发此报错。

创建基础配置文件
ast-grep默认在用户主目录（~/.ast-grep.yml）或当前项目根目录查找配置文件。如果两者都没有，直接创建一个空的基础配置：
```
touch ~/.ast-grep.yml
```
可以写入最基本的配置内容避免后续规则加载问题：
```
rules: {}
```
修正Neovim的LSP配置路径
如果你用lspconfig配置ast-grep，检查是否错误指定了配置文件路径。确保settings.ast_grep.configPath指向存在的文件，示例配置片段：
```
require('lspconfig').ast_grep.setup({
  settings = {
    ast_grep = {
      configPath = vim.fn.expand('~/.ast-grep.yml')
    }
  }
})
```
确认ast-grep安装状态
在终端执行sg --version验证ast-grep是否正常安装。如果未安装，用Arch包管理器安装：
```
sudo pacman -S ast-grep
```
若通过Cargo安装，确保~/.cargo/bin在系统PATH中，保证Neovim能找到sg命令。
切换到正确的工作目录
ast-grep会优先读取当前工作目录的配置文件。如果在项目中打开Neovim，先通过终端切换到项目根目录再启动Neovim，或者在Neovim中执行:cd /path/to/your/project切换目录。