# 道-中文编程语言

**Repository Path**: kaisen-wang/dao

## Basic Information

- **Project Name**: 道-中文编程语言
- **Description**: "道"是一种全新的通用编程语言，专为中文使用者设计。它的目标不仅是降低编程门槛，更是探索如何将面向对象、函数式、逻辑编程和元编程四大范式优雅地融合在统一的中文语法框架下。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 道（Dao）— 多范式中文编程语言

> 一门基于简体中文的、融合四大编程范式的现代高级编程语言

## 🎯 项目简介

"道"是一种全新的通用编程语言，专为中文使用者设计。它的目标不仅是降低编程门槛，更是探索如何将面向对象、函数式、逻辑编程和元编程四大范式优雅地融合在统一的中文语法框架下。

**核心特性：**
- 🇨🇳 **中文原生** — 所有关键字使用简体中文，语法贴合中文表达习惯
- 🔀 **四范式融合** — OOP + FP + 逻辑编程 + 元编程，各司其职、无缝协作
- ⚡ **动态类型** — 灵活高效，可选类型注解满足大型项目需求
- 📦 **字节码运行** — 编译至中间字节码，跨平台 + JIT 高性能
- 🧩 **管道驱动** — `|>` 运算符让数据流动像流水线一样清晰

## 🚀 快速开始

```bash
# 进入源码目录
cd 源码

# 安装依赖（需要 Python 3.10+）
pip install -r requirements.txt

# 启动交互式命令行（REPL）
python main.py

# 执行 .道 文件
python main.py examples/你好世界.道

# 运行测试
pytest tests/ -v
```

**REPL 示例：**
```
道 > 打印("你好，世界！")
你好，世界！

道 > 定义 x = 42
道 > 打印(x * 2)
84

道 > 函数 加法(甲, 乙)
...     返回 甲 + 乙
...
道 > 打印(加法(3, 4))
7
```

## 🔑 语法速览

```
// 变量与函数
定义 名字 = "张三"
常量 版本 = "1.0"

函数 打招呼(名字)
    返回 `你好，{名字}！`

// 面向对象
类型 动物
    初始化(名字)
        本对象.名字 = 名字
    函数 说话()
        打印(`我是{本对象.名字}`)

// 函数式管道
定义 结果 = [1, 2, 3, 4, 5]
    |> 筛选(_ > 2)
    |> 映射(_ * 10)
    // => [30, 40, 50]

// 逻辑编程
逻辑 知识库
    事实: 朋友("甲", "乙")
    规则: 间接朋友(?a, ?c) 如果
        朋友(?a, ?b) 并且 朋友(?b, ?c)

// 异步并发
异步 函数 获取数据()
    定义 结果 = 等待 网络.请求("/api/data")
    返回 结果
```

## 📚 设计文档

设计文档存放在 `文档/` 目录下，按主题分为 13 个章节：

| # | 文件 | 内容 |
|---|------|------|
| 1 | [引言](文档/01-引言.md) | 背景动机、设计目标、报告结构 |
| 2 | [核心语法](文档/02-核心语法.md) | 注释、变量、数据类型、字符串插值、解构、控制流、函数、错误处理、运算符 |
| 3 | [面向对象编程](文档/03-面向对象编程.md) | 类型、继承、特征、抽象类型、静态方法、运算符重载、属性访问器 |
| 4 | [函数式编程](文档/04-函数式编程.md) | 高阶函数、管道运算符、柯里化、函数组合、模式匹配、惰性求值 |
| 5 | [逻辑编程](文档/05-逻辑编程.md) | 事实/规则/查询、否定、约束、剪枝、动态事实 |
| 6 | [元编程](文档/06-元编程.md) | 宏定义、引述/注入、实用宏、AST内省、卫生宏 |
| 7 | [模块系统](文档/07-模块系统.md) | 导入/导出、包管理、条件导入 |
| 8 | [并发编程](文档/08-并发编程.md) | 异步/等待、协程/通道、选择器、并发安全 |
| 9 | [类型系统与运行时](文档/09-类型系统与运行时.md) | 动态类型、可选注解、字节码编译、VM平台评估 |
| 10 | [标准库](文档/10-标准库.md) | 文本、数学、文件、网络、时间、编码、测试等核心模块 |
| 11 | [关键字总表](文档/11-关键字总表.md) | 全部约75个关键字分类速查表 |
| 12 | [综合示例](文档/12-综合示例.md) | 博客推荐系统 — 四范式协作实战 |
| 13 | [结论与展望](文档/13-结论与展望.md) | 总结、挑战、实施路线图 |

> 📄 原始的完整研究报告保存在 [文档.md](文档.md)  
> 📋 详细开发计划见 [开发计划.md](开发计划.md)

## 🗺️ 开发路线图

| 阶段 | 时间 | 目标 | 当前状态 |
|------|------|------|---------|
| **Phase 1** | 第 1-8 周 | 核心原型：Lexer + Parser + 解释器 + REPL | ✅ 完成 |
| **Phase 2** | 第 9-20 周 | OOP + FP：类型系统、高阶函数、模式匹配、模块 | ✅ 大部分完成 |
| **Phase 3** | 第 21-40 周 | 高级特性：逻辑引擎、宏系统、并发 | ⬜ 待开始 |
| **Phase 4** | 第 41 周+ | 字节码编译 + GraalVM 迁移 + 生态建设 | ⬜ 待开始 |

## 📁 项目结构

```
道/
├── readme.md               ← 你正在读的文件
├── 文档.md                 ← 原始完整研究报告
├── 开发计划.md             ← 详细开发计划与任务清单
├── 文档/                   ← 分章节设计文档（13章）
│   ├── 01-引言.md
│   ├── 02-核心语法.md
│   ├── 03-面向对象编程.md
│   ├── 04-函数式编程.md
│   ├── 05-逻辑编程.md
│   ├── 06-元编程.md
│   ├── 07-模块系统.md
│   ├── 08-并发编程.md
│   ├── 09-类型系统与运行时.md
│   ├── 10-标准库.md
│   ├── 11-关键字总表.md
│   ├── 12-综合示例.md
│   └── 13-结论与展望.md
└── 源码/                   ← 解释器源代码（Python 3.10+）
    ├── main.py             ← 主入口（REPL + 文件执行）
    ├── requirements.txt    ← Python 依赖
    ├── dao/                ← 核心解释器包
    │   ├── tokens.py       ← 词元类型定义（32个关键字）
    │   ├── ast_nodes.py    ← AST 节点定义（30+节点类型）
    │   ├── environment.py  ← 词法作用域管理
    │   ├── errors.py       ← 中文错误类型
    │   ├── lexer/          ← 词法分析器包
    │   │   ├── core.py        ← 核心类（初始化+主循环+缩进）
    │   │   └── readers.py     ← Token读取（字符串/数值/运算符等）
    │   ├── parser/         ← 语法分析器包
    │   │   ├── core.py        ← 核心类（初始化+基础设施）
    │   │   ├── statements.py  ← 语句解析（声明/控制流/OOP等）
    │   │   └── expressions.py ← 表达式解析（优先级/调用/字面量等）
    │   ├── builtins/       ← 内置函数包
    │   │   ├── callables.py   ← 可调用类型基类
    │   │   ├── oop_types.py   ← OOP 类型（类/实例/方法）
    │   │   ├── functions.py   ← 基础内置函数（打印/长度等）
    │   │   └── hof.py         ← 高阶函数（映射/筛选/折叠等）
    │   └── interpreter/    ← 解释器包
    │       ├── core.py        ← 核心类（组合混入+辅助方法）
    │       ├── statements.py  ← 语句执行（声明/控制流/OOP等）
    │       └── expressions.py ← 表达式求值（运算/调用/管道等）
    ├── tests/              ← 测试套件（145个测试）
    │   ├── test_lexer.py          ← 词法分析器测试
    │   ├── test_parser.py         ← 语法分析器测试
    │   ├── test_interpreter.py    ← 解释器测试
    │   ├── test_new_features.py   ← 新特性测试
    │   └── test_integration.py    ← 集成测试（运行.道示例）
    └── examples/           ← 示例程序（8个）
        ├── 你好世界.道
        ├── 基础示例.道
        ├── 斐波那契.道
        ├── 面向对象.道
        ├── 高阶函数.道
        ├── 模式匹配.道
        ├── 综合示例.道
        └── 新特性示例.道
```

## 🛠️ 技术架构

```
源代码(.道文件)
    ↓ [词法分析 lexer.py]
Token 流
    ↓ [语法分析 parser.py]
抽象语法树 (AST)
    ↓ [树遍历 interpreter.py]
执行结果
```

**当前实现**（Phase 1）：Python 树遍历解释器  
**目标架构**（Phase 4）：编译到字节码 → GraalVM/Truffle JIT 执行