开源项目 `99c` 使用教程

开源项目 99c 使用教程

99cgithub.com/cznic/99c has moved to modernc.org/99c项目地址:https://gitcode.com/gh_mirrors/99/99c

1. 项目的目录结构及介绍

99c 项目的目录结构如下：

99c/
├── cmd/
│   └── 99c/
│       └── main.go
├── internal/
│   ├── compiler/
│   ├── parser/
│   └── vm/
├── vendor/
├── go.mod
├── go.sum
└── README.md

目录结构介绍

• cmd/: 包含项目的入口文件。
  • 99c/: 具体的命令行工具目录。
    • main.go: 项目的启动文件。
• internal/: 包含项目的内部实现模块。
  • compiler/: 编译器相关代码。
  • parser/: 解析器相关代码。
  • vm/: 虚拟机相关代码。
• vendor/: 依赖包管理目录。
• go.mod: Go 模块文件，定义项目依赖。
• go.sum: 依赖包的校验文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/99c/main.go。该文件主要负责初始化项目并启动程序。以下是 main.go 的主要内容：

package main

import (
    "fmt"
    "os"

    "github.com/cznic/99c/internal/compiler"
    "github.com/cznic/99c/internal/parser"
    "github.com/cznic/99c/internal/vm"
)

func main() {
    // 初始化编译器、解析器和虚拟机
    c := compiler.NewCompiler()
    p := parser.NewParser()
    v := vm.NewVM()

    // 解析命令行参数
    if len(os.Args) < 2 {
        fmt.Println("Usage: 99c <file>")
        os.Exit(1)
    }

    // 编译并运行代码
    err := c.Compile(os.Args[1])
    if err != nil {
        fmt.Println("Compile error:", err)
        os.Exit(1)
    }

    err = v.Run(c.Bytecode())
    if err != nil {
        fmt.Println("Runtime error:", err)
        os.Exit(1)
    }
}

启动文件介绍

• main 函数：初始化编译器、解析器和虚拟机，并根据命令行参数编译和运行代码。
• os.Args：获取命令行参数，至少需要一个文件路径。
• compiler.Compile：编译指定文件。
• vm.Run：运行编译后的字节码。

3. 项目的配置文件介绍

99c 项目没有显式的配置文件，其配置主要通过命令行参数和代码内部实现来完成。例如，编译和运行代码的文件路径通过命令行参数传递。

配置方式

• 命令行参数：通过 os.Args 获取，至少需要一个文件路径。
• 代码内部配置：通过初始化编译器、解析器和虚拟机来实现。

以上是 99c 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置方式。希望对您有所帮助！

99cgithub.com/cznic/99c has moved to modernc.org/99c项目地址:https://gitcode.com/gh_mirrors/99/99c