Skip to main content
本指南涵盖调试、运行服务器测试套件以及参与 VillageSQL 的开发。它假定您已有一个可用的源码构建——如果尚未完成，请参阅从源代码构建。

​
调试

VillageSQL 服务器调试在 Linux 上使用 GDB，在 macOS 上使用 lldb。macOS 上的 GDB 需要代码签名，设置起来很麻烦——lldb 是标准的 macOS 调试器，开箱即用。

​
Linux（GDB）

在 GDB 下运行 VillageSQL：
在 GDB 内部：
常用 GDB 命令：

​
macOS（lldb）

在 lldb 下运行 VillageSQL：
在 lldb 内部：
常用 lldb 命令：

​
运行测试

VillageSQL 包含单元测试和回归测试，以验证功能。

​
单元测试

运行 VillageSQL 特定的单元测试（从您的构建目录中）：
或者运行所有单元测试：

​
回归测试

切换到 mysql-test 目录：
运行完整的 MySQL 测试套件（速度较慢）：
运行一个 VillageSQL 子套件：
运行 VillageSQL 测试，包括所有子套件：
—suite 与 —do-suite：
  • --suite=villagesql/insert 运行一个子套件
  • --do-suite=villagesql 运行所有测试，包括子套件（insert、select、stored_procedure 等）
  • --nounit-tests 跳过 MTR 原本会随套件一起运行的单元测试。这些是上游 MySQL 的单元测试，其中包含已知的失败；请使用上面的单元测试命令单独运行 VillageSQL 的单元测试。

​
运行单个测试

通过名称运行特定的测试：
从子套件中运行测试：

​
更新测试结果

如果您更改了功能并需要更新预期的测试输出：
测试记录： 始终检查 .result 文件的更改，以确保它们反映了预期的行为，而不是错误。--record 标志会盲目地覆盖预期的输出。

​
测试可移植性

当测试输出包含来自测试运行程序的临时目录的路径时，请在每条会打印此类路径的语句之前添加以下指令，这样记录的结果就不会包含在其他机器上会出错的绝对路径：

​
调试测试失败

VillageSQL 特定的日志消息（通过 LogVSQL() 发出）在 --log-error-verbosity=3 时写入错误日志，MTR 默认设置该级别。要为单次运行设置该级别：
单工作进程运行时，完整的错误日志位于 mysql-test/var/log/mysqld.1.err。使用 --parallel 时，每个工作进程改为写入 mysql-test/var/<N>/log/mysqld.1.err。 有关编写扩展回归测试，请参阅 C++ 测试。

​
安装二进制文件

要在系统范围内安装 VillageSQL（需要适当的权限）：
这会将二进制文件默认安装到 /usr/local/mysql/。您可以自定义安装前缀：

​
贡献

如果您要为 VillageSQL 做出贡献，请参阅贡献指南，了解编码标准和开发流程。