GitHub_Trending/992/99支持的文件类型扩展：自定义语言支持完整指南

【免费下载链接】99 Neovim AI agent done right 项目地址: https://gitcode.com/GitHub_Trending/992/99

GitHub_Trending/992/99作为一款功能强大的Neovim AI agent，提供了灵活的文件类型扩展机制，让用户能够轻松添加对新编程语言的支持。本文将详细介绍如何为该项目自定义语言支持，从了解现有支持到创建全新语言配置，帮助你充分发挥Neovim AI agent的潜力。

现有支持的文件类型概览

GitHub_Trending/992/99默认已支持多种主流编程语言，这些语言配置文件位于lua/99/language/目录下，包括：

• C++ (cpp.lua)
• Elixir (elixir.lua)
• Go (go.lua)
• Java (java.lua)
• Lua (lua.lua)
• Ruby (ruby.lua)
• TypeScript (typescript.lua)

每种语言支持都包含特定的操作逻辑和语法分析规则，这些规则通过Tree-sitter查询文件实现，存储在queries/目录中，例如C++的查询规则位于queries/cpp/目录下。

自定义语言支持的基本步骤

添加新的语言支持主要涉及两个核心步骤：创建语言配置模块和定义Tree-sitter查询规则。这一过程不需要复杂的编程知识，只需按照模板进行修改即可快速上手。

创建语言配置模块

1. 在语言目录下新建配置文件
   在lua/99/language/目录中创建新的Lua文件，文件名应与Neovim的文件类型（filetype）保持一致。例如，要添加Python支持，创建python.lua。

2. 定义语言操作模块
   每个语言模块需要导出特定的操作函数和名称映射。基础模板如下：

local M = {}

-- 定义语言特定的名称映射
M.names = {
  body = "block",          -- 函数体节点名称
  function_declaration = "function_definition",  -- 函数声明节点名称
  -- 其他语法节点映射...
}

-- 实现日志项格式化函数
function M.log_item(item_name)
  return string.format("Logging: %s", item_name)
end

return M

3. 注册语言支持
   修改语言初始化文件lua/99/language/init.lua，在初始化函数中添加新语言：

function M.initialize(_99)
  M.languages = {}
  -- 在现有列表中添加新语言
  for _, lang in ipairs({... , "python"}) do  -- 添加"python"到语言列表
    M.languages[lang] = require("99.language." .. lang)
  end
end

编写Tree-sitter查询规则

Tree-sitter查询文件用于语法分析，帮助AI agent理解代码结构。这些文件需要放置在queries/目录下对应的语言子目录中：

1. 创建查询目录
   为新语言创建目录，例如queries/python/。

2. 定义函数查询规则
   创建99-function.scm文件，定义函数识别规则：

; 匹配Python函数定义
(function_definition
  name: (identifier) @function.name
  body: (block) @function.body
)

3. 添加导入语句查询（如需要）
   创建99-imports.scm文件识别导入语句：

; 匹配Python导入语句
(import_statement (identifier) @import.name)
(from_import_statement (identifier) @import.name)

验证与测试新语言支持

添加自定义语言支持后，建议通过以下方式验证功能：

1. 创建测试文件
   使用测试工具函数创建测试文件，可参考test_utils.lua中的create_file方法：

-- 示例：创建Python测试文件
test_utils.create_file("def hello(): print('hi')", "python", 1, 0)

2. 检查语言加载状态
   通过日志确认新语言已正确加载：

-- 在Neovim中执行
:lua print(vim.inspect(require('99.language').languages.python))

3. 运行功能测试
   编写测试用例验证语言功能，可参考test/目录下的现有测试文件结构。

常见问题解决

语言未被识别

若出现"language currently not supported"错误，检查：

• 语言配置文件是否正确放置在lua/99/language/目录
• 文件名是否与Neovim的filetype一致（可通过:set filetype?命令查看当前文件类型）
• 是否已在初始化函数中注册新语言

Tree-sitter查询不生效

若语法分析异常，确认：

• 查询文件路径是否正确（queries/语言名/）
• 查询语法是否符合Tree-sitter规范
• Neovim已安装对应语言的Tree-sitter解析器

最佳实践与扩展建议

• 保持配置一致性：参考现有语言配置文件的结构和命名约定
• 复用公共逻辑：将通用功能抽象到utils.lua中
• 完善文档：为自定义语言支持添加注释和使用说明
• 参与社区贡献：将完善的语言支持提交给项目，帮助其他用户

通过以上步骤，你可以轻松扩展GitHub_Trending/992/99的语言支持，使其更好地适应你的开发需求。无论是主流编程语言还是小众领域特定语言，灵活的扩展机制都能让Neovim AI agent成为你高效开发的得力助手。

【免费下载链接】99 Neovim AI agent done right 项目地址: https://gitcode.com/GitHub_Trending/992/99