82 lines
1.7 KiB
Markdown
82 lines
1.7 KiB
Markdown
# 快速开始
|
|
|
|
## 运行 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"` |