Covariant Script 编程语言解释器

欢迎使用Covariant Script编程语言!
Covariant Script是一种开源的跨平台编程语言
此项目为官方维护的Covariant Script解释器

赞助此项目 - 支持开发，共建社区未来

切换语言

• 简体中文
• English

特点

• 全平台可用，支持大多数主流操作系统
  • Apple macOS: 通用二进制，同时支持 x86_64 (Intel) 和 ARM64 (Apple Silicon)
  • Linux 和类 Unix: x86, ARM, MIPS, LoongArch
  • Microsoft Windows: x86, ARM
  • [New!] Google Android: x86, ARM (在 Termux 环境中可运行完整环境)
• 强大易用的扩展系统
  • C/C++ Native Interface(CNI) 系统：能够翻译 C/C++ 和 Covariant Script 之间的双向调用
  • Interpreter Bootstrap：在 C++ 项目中集成 Covariant Script 运行时环境的帮手
  • CNI 组成宏：将扩展系统与CNI系统有机结合，现已纳入语言标准
  • CFFI 支持: 直接调用使用 C 语言编写的动态库中的函数
• 自研高效编译系统
  • 针对中文优化的 Unicode 支持
  • 无依赖、高效的编译器前端
  • 支持编译期优化
  • 可导出编译结果
• 高性能运行时环境
  • 堆栈式非对称协程
  • 热点分析优化算法
  • 高效的内存管理系统
  • 引用计数垃圾回收器
• 全面支持国产信创环境
  • 处理器：龙芯（MIPS/LoongArch）、鲲鹏/飞腾（ARM）、海光/兆芯（x86）
  • 操作系统：支持大多数 Linux 衍生系统，在 UOS、openEuler 中经过测试
  • 加密算法：支持主流的国密 SM2、SM3、SM4 算法

文档

请访问 Covariant Script OSC README

Codespace

您可以在 GitHub Codespace 中免安装直接使用 CovScript：

安装

• [建议] 从 covscript.org.cn 下载安装包
• 在 Latest Release 里下载预编译的二进制文件
• 使用 CMake 工具链直接编译源代码

运行

解释器

cs [选项...] <文件|STDIN> [参数...]
cs [选项...]

当将 文件 换成 STDIN 时，解释器会直接从标准输入流读取

选项

解释器

选项	助记符	功能
--compile-only	-c	仅编译
--dump-ast	-d	导出高级语法树
--dependency	-r	导出模块依赖
--csym <文件>	-g <文件>	从文件中读取 cSYM 信息

交互式解释器(Repl)

选项	助记符	功能
--silent	-s	关闭命令提示符
--args <...>	-a <...>	设置程序参数

注意，在选项 --args 或其助记符 -a 之后设置的每一项都将被视为参数

通用选项

选项	助记符	功能
--no-optimize	-o	禁用优化器
--help	-h	显示帮助信息
--version	-v	显示版本信息
--wait-before-exit	-w	等待进程退出
--stack-resize <大小>	-S <大小>	重设运行时栈大小
--log-path <路径>	-l <路径>	设置日志输出路径
--import-path <路径>	-i <路径>	设置引入查找路径

默认栈大小为64。这只是初始预留大小，栈会根据需要自动增长，其上限取决于系统对栈的限制。当设置的栈大小为1000或更大时，协程的栈大小会动态调整为设置大小的十分之一；当设置的栈大小小于1000时，协程的栈大小将保持在64

注意，若不设置日志输出路径，将直接输出至标准输出流

调试器

cs_dbg [选项...] <文件>

选项

选项	助记符	功能
--help	-h	显示帮助信息
--version	-v	显示版本信息
--silent	-s	关闭命令提示符
--wait-before-exit	-w	等待进程退出
--csym <文件>	-g <文件>	从文件中读取 cSYM 信息
--stack-resize <大小>	-S <大小>	重设运行时栈大小
--log-path <路径>	-l <路径>	设置日志路径
--import-path <路径>	-i <路径>	设置引入查找路径

栈大小策略与解释器相同

若不设置日志路径，将直接输出至标准输出流

示例

仓库 covscript-example 中包含了数个使用 Covariant Script 编写的示例程序。

版权

Covariant Script 编程语言的作者是 @mikecovlee，基于 Apache 2.0 协议分发。
版权所有 © 2017-2026 李登淳(Michael Lee)
该软件已在中华人民共和国国家版权局注册（登记号：2020SR0408026），受中华人民共和国著作权法保护。

贡献者福利

加入我们的贡献者行列，你会得到： - 你的名字/GitHub 账号永远被保留在项目历史中 - 代码贡献通过 Git 自动署名 - 重要贡献者有机会在版本发布说明中被提及 - 你保留对贡献代码的著作权（Apache 2.0 协议） - 活跃贡献者有机会从赞助资金中获得分红（按年度根据贡献度分配）

想看看谁已经为项目做出了贡献？来逛逛我们的贡献者页面吧！详细的赞助和分红说明，请查看 赞助页面。

相关项目

为了更好的 CovScript 体验，我们推荐以下官方项目：

• 官方手册 - 完整的入门指南、教程和最佳实践文档
• VSCode 扩展 - 官方 VSCode 扩展，提供语法高亮、代码补全和调试支持
• 包管理器 (cspkg) - 官方包管理系统，便于依赖管理和包分发
• 示例项目 - 精选示例程序和常见用法

开发工具

IDE 和编辑器支持

• VSCode 扩展 - 推荐使用，支持完整的语言功能
• 包管理器 - 使用 cspkg 命令行工具管理依赖
• 官方手册 - 包含完整文档和学习资源

社区交流

• GitHub Discussions - 讨论和提问
• GitHub Issues - 报告 Bug 和建议功能
• 微信群 - 发邮件至 mikecovlee@163.com 加入社区

引用

如果 CovScript 为您的工作增添了一些便利，请引用该仓库。

@misc{CovScript,
  author = {Li, Dengchun},
  title = {Covariant Script Programming Language},
  year = {2017},
  publisher = {GitHub},
  howpublished = {\url{https://github.com/covscript/covscript}}
}

感谢

四川大学, KDDE Lab (段磊教授), freeCodeCamp 成都社区

@imkiva, @ice1000, @MouriNaruto, Weicheng Shi