# 快速开始

## 运行 Fig 程序

Fig 语言通过解释器直接执行源代码文件。基本执行命令如下：

`./Fig 你的脚本.fig`

### 查看帮助和版本

显示帮助信息：
`./Fig -h` 或 `./Fig --help`

显示版本信息：
`./Fig -v` 或 `./Fig --version`

### 示例

创建一个名为 `hello.fig` 的文件，内容为：

```go
import std.io;
io.println("Hello, Fig!");
```

在终端中运行：
`./Fig hello.fig`

你会看到输出：`Hello, Fig!`

## 程序示例

### 简单表达式程序

Fig 程序可以只包含表达式：

```go
1 + 2 * 3
```

运行此程序会输出计算结果 `7`。

### 带变量的程序

```go
var x = 10;
var y = x * 2;
y + 5
```

运行输出 `25`。

## 错误处理

当源代码有语法或类型错误时，解释器会显示详细的错误信息。例如：

```rust
An error occurred! Fig 0.4.2-alpha (2026-01-23 01:30:46)[llvm-mingw 64 bit on `Windows`]
✖  TypeError: Variable `x` expects init-value type `Int`, but got 'Double'
    at 1:14 in file 'your_file.fig'
    var x: Int = 3.14;
                 ^
```

错误信息包括：
- 错误类型和描述
- 发生错误的文件和位置
- 相关的堆栈跟踪信息

## 运行流程

1. **编写代码**：使用任何文本编辑器创建 `.fig` 文件
2. **保存文件**：确保文件扩展名为 `.fig`
3. **执行程序**：在终端中运行 `./Fig 文件名.fig`
4. **查看结果**：程序输出显示在终端中
5. **调试错误**：根据错误信息修改代码

## 注意事项

- Fig 源文件必须使用 UTF-8 编码
- 语句通常以分号结束，但程序最后一条表达式可以省略分号
- 文件路径可以包含空格，但建议使用引号包裹：`./Fig "my script.fig"`