文言编程环境部署与实战指南

项目特性解析：重新定义编程表达

wenyan-lang作为一款独特的文言文编程语言，将传统文学与现代编程范式深度融合。其核心特性包括三方面：创新性语法系统，采用"吾有一术"等文言表达构建函数定义；多语言编译支持，可将文言代码转换为JavaScript、Python或Ruby；以及丰富的标准库体系，如lib/算經.wy提供数学运算、lib/列經.wy实现数组操作。这种文化与技术的跨界融合，为编程教育和传统文化传播提供了全新载体。

零基础配置：环境部署完整流程

系统环境准备

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/weny/wenyan-lang
cd wenyan-lang

# 安装项目依赖
npm install

[!TIP] 确保Node.js版本≥14.0.0，可通过node -v命令验证版本。Windows用户建议使用WSL环境避免路径兼容问题。

构建与验证

# 编译TypeScript源码
npm run build

# 验证安装完整性
npm test

成功安装后，可通过npx wenyan --version命令确认工具链版本信息。

核心功能探索：命令速查与基础操作

编译模式详解

# 基础编译（默认输出JavaScript）
npx wenyan examples/helloworld.wy

# 指定输出语言为Python
npx wenyan examples/fibonacci.wy --lang py --compile

# 生成SVG可视化
npx wenyan examples/draw_heart.wy --render

交互式开发

# 启动REPL环境
npx wenyan --interactive

# 在交互模式中执行代码
> 吾有一言。曰「「試探文言编程」」。書之。
試探文言编程

数学运算功能请参见lib/算經.wy模块，提供加减乘除、开方等基础运算，以及三角函数等高级计算能力。

进阶应用技巧：从示例到实战

模块化开发

// 导入标准库
引「算經」。

// 定义函数
吾有一術。名之曰「斐波那契」。欲行是術。必先得一數。曰「n」。
  若n小於三。則返一。
  若非。則返「斐波那契」(n減一)與「斐波那契」(n減二)之和。
是術云。

常见问题解决

1. 编译错误："未找到模块"

   • 检查文件路径是否正确，标准库需放在lib目录下
   • 确认导入语法正确：引「算經」。（注意使用全角引号）

2. 运行时异常："变量未定义"

   • 文言编程要求变量声明前置，使用吾有一數。曰「x」。语法
   • 检查是否遗漏書之。等输出语句结尾标识

3. 可视化渲染失败

   • 确保已安装SVG支持库：npm install svgjs
   • 复杂图形可能需要增加内存限制：NODE_OPTIONS=--max-old-space-size=4096 npx wenyan

通过examples目录下的mandelbrot.wy和turing.wy等高级示例，可深入了解文言编程在复杂算法实现中的应用技巧。建议配合documentation目录下的技术文档进行学习，逐步掌握宏定义、异常处理等高级特性。