pegtool 使用 Go 编写。下面统一使用命令名 pegtool。
从 Go 模块安装最新版本：
go install github.com/fy0/pegtool@latest
pegtool -h从当前仓库构建：
go build -o .\bin\pegtool.exe .::: tip 使用其他目标语言 本节以 Go 为例。要生成其他语言的 parser，请直接查看 Haxe、TypeScript、C#、C99 或 Rust 的最小可运行示例。
不准备运行 Go 示例？可以跳到切换目标语言，或直接查看下一步。 :::
新建 identifier.peg。下面的 Go 文法识别一个 Unicode 标识符，并返回捕获到的文本：
{
package main
type ParserCustomData struct{}
func ParseIdentifier(filename string, input []byte) (string, error) {
value, err := parse(filename, input)
if err != nil {
return "", err
}
return value.(string), nil
}
}
Start = value:<Identifier> !. {
return value
}
Identifier = [\pL_] [\pL\p{Nd}_]*
这里的关键点是：
- initializer 中的 Go 代码声明生成文件所属的 package 和公开调用函数。
- 即使不使用自定义状态，Go target 也需要声明空的
ParserCustomData。 - 第一条规则是默认入口。
<Identifier>显式捕获匹配文本。!.要求输入已经结束，避免只接受合法前缀。\pL和\p{Nd}使用生成器所认识的 Unicode 类。
go mod init example.com/identifier
pegtool -t go -o parser.go identifier.peg新建 main.go 调用生成的 parser：
package main
import "fmt"
func main() {
value, err := ParseIdentifier("input.txt", []byte("name_世界"))
if err != nil {
panic(err)
}
fmt.Println(value)
}编译并运行：
go run .
# 输出：name_世界使用 -t 或 -target 选择输出：
| 目标 | 参数 | 常用输出名 |
|---|---|---|
| Go | go |
parser.go |
| Haxe | hx、haxe |
Parser.hx |
| TypeScript | ts、typescript |
parser.ts |
| C# | cs、csharp、c# |
Parser.cs |
| C99 | c、c99 |
parser.c |
| Rust | rust |
parser.rs |
文法中的动作代码属于目标语言。需要从同一文件生成多种语言时，使用目标条件模板。