注意：如果您没有单独编译 NSS，您需要安装 mercurial (hg)。NSS 构建还需要 gyp 和 ninja（或 ninja-build）。

调试 Neqo

QUIC 日志记录

启用 QLOG：

$ mkdir "$logdir"
$ ./target/debug/neqo-server '[::]:12345' --db ./test-fixture/db --qlog-dir "$logdir"
$ ./target/debug/neqo-client 'https://[::]:12345/' --qlog-dir "$logdir"

您可以使用 https://qvis.quictools.info/ 通过上传 QLOG 文件来可视化流。

使用 SSLKEYLOGFILE 解密 Wireshark 日志

信息在这里

TODO：需要 Wireshark 的最低版本是多少？ TODO：上述链接可能不正确，协议现在称为 TLS 而不是 SSL？

有效地使用 RUST_LOG

如 env_logger 文档 中所述，RUST_LOG 环境变量可以用于选择性地启用 Rust 代码中的日志消息。这对于 Neqo 的命令行工具以及 Neqo 集成到 Gecko 中时都有效，尽管 Gecko 需要在调试模式下构建。

一些示例

1. RUST_LOG=neqo_transport::dump ./mach run 只列出发送和接收的 QUIC 数据包及其帧内容。
2. RUST_LOG=neqo_transport=debug,neqo_http3=trace,info ./mach run 为传输设置 'debug' 日志级别，为 http3 设置 'trace' 日志级别，并为 Neqo 和 Gecko 使用的其他所有 Rust 包设置 'info' 日志级别。
3. RUST_LOG=neqo=trace,error ./mach run 为以 "neqo" 开头的所有模块设置 trace 级别，并将 error 设置为其他不相关 Rust 日志消息的最小日志级别。

在 Gecko 中尝试开发中的 Neqo 代码

在已检出的 Gecko 源代码副本中，将四个 Neqo 包的 [patches.*] 值设置为根 Cargo.toml 中的本地版本。例如，如果 Neqo 已检出到 /home/alice/git/neqo，请向根 Cargo.toml 中添加以下行。

[patch."https://github.com/mozilla/neqo"]
neqo-http3 = { path = "/home/alice/git/neqo/neqo-http3" }
neqo-transport = { path = "/home/alice/git/neqo/neqo-transport" }
neqo-common = { path = "/home/alice/git/neqo/neqo-common" }
neqo-qpack = { path = "/home/alice/git/neqo/neqo-qpack" }
neqo-crypto = { path = "/home/alice/git/neqo/neqo-crypto" }

然后执行以下操作

./mach vendor rust

使用 ./mach build 正常编译 Gecko。

注意：如果 Neqo 代码有变化，使用较新的 Neqo 代码与 Gecko 一起使用可能也需要更改（可能是对 neqo_glue 的更改）。