Mini Language Support

为 Mini 脚本语言提供语法高亮、代码补全和错误检查的 VSCode 扩展。

特性

• 语法高亮 - 支持关键字、字符串、数字、注释等
• 代码补全 - 输入时自动提示关键字和函数
• 错误检查 - 实时检测语法错误和未闭合语句
• 代码片段 - 快速生成常用代码结构
• 运行命令 - 直接在编辑器中运行 Mini 脚本
• 语言配置 - 自动缩进、括号匹配等

安装

从 VSIX 文件安装

1. 从 Releases 下载 .vsix 文件
2. 在 VSCode 中按 Ctrl+Shift+P
3. 输入 Extensions: Install from VSIX
4. 选择下载的文件

从 OVSX 安装

1. 访问 https://open-vsx.org/extension/hechenyv/mini-lang-vscode
2. 点击 Download
3. 在 VSCode 中按 Ctrl+Shift+P
4. 输入 `Extensions: Install from VSIX
5. 选择下载的文件

本地开发安装

方式一：使用一键构建脚本（推荐）

项目提供了三个平台的自动化构建脚本，会自动安装 nvm、Node.js、vsce，并完成编译打包：

系统	脚本	运行方式
Windows	build.bat	右键 → 以管理员身份运行
Linux	build.sh	chmod +x build.sh && ./build.sh
macOS	build.sh	chmod +x build.sh && ./build.sh

方式二：手动构建

git clone https://gitcode.com/hechenyv/mini-lang-vscode.git
cd mini-lang-vscode
npm install
npm run compile

按 F5 启动调试。

使用方法

文件关联

扩展会自动识别以下文件：

• .mi - Mini 脚本文件
• .mini - Mini 脚本文件

代码片段

快捷键	生成代码
var + Tab	var name:type = value
set + Tab	set name = value
if + Tab	if condition then ... endif
ifn + Tab	if condition then ... endif (无 else)
writeln + Tab	writeln(value)
write + Tab	write(value)
readln + Tab	readln(type)
arr + Tab	[element1, element2]

语法示例

# 变量定义
var name:str = "Mini"
var age:int = 18
var score:float = 95.5
var is_active:bool = True
var list:arr = [1, 2, 3]

# 输入输出
writeln("Hello, " + name)
write("请输入年龄: ")
var input:int = readln(int)

# 条件判断
if age >= 18 then
    writeln("成年人")
else
    writeln("未成年人")
endif

# 数组操作
var numbers:arr = [1, 2, 3, 4, 5]
writeln(numbers[0])

# 字符串分割
var words:arr = readln(str).split()
var csv:arr = readln(str).split(',')

配置

在 VSCode 设置中搜索 mini 可配置以下选项：

配置项	默认值	说明
mini.executablePath	mini	Mini 可执行文件路径
mini.enableDiagnostics	true	启用实时错误检查
mini.enableCompletion	true	启用代码补全
mini.enableHover	true	启用悬停提示
mini.maxErrors	100	最大错误显示数量
mini.formatOnSave	false	保存时自动格式化
mini.indentSize	4	缩进大小（空格数）
mini.useTabs	false	使用制表符缩进
mini.lintOnType	true	输入时实时检查
mini.delay	500	检查延迟（毫秒）

开发

环境要求

• Node.js >= 16.x
• VSCode >= 1.74.0

开发命令

# 安装依赖
npm install

# 编译 TypeScript
npm run compile

# 监听文件变化
npm run watch

# 调试扩展
# 在 VSCode 中按 Ctrl+Shift+D，然后点击运行

# 打包扩展
npm install -g @vscode/vsce
vsce package

项目结构

mini-lang-vscode/
├── src/
│   └── extension.ts          # 扩展入口
├── syntaxes/
│   └── mini.tmLanguage.json  # 语法高亮定义
├── snippets/
│   └── mini.json             # 代码片段
├── package.json              # 扩展配置
├── tsconfig.json             # TypeScript 配置
├── build.bat                 # Windows 构建脚本
├── build.sh                  # Linux/macOS 构建脚本
└── language-configuration.json # 语言配置

许可证

本项目使用 GNU General Public License v3.0 许可证。

详见 LICENSE 文件。

作者

何辰宇

• GitCode: @hechenyv

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建你的功能分支: git checkout -b feature/amazing
3. 提交更改: git commit -m 'Add amazing feature'
4. 推送: git push origin feature/amazing
5. 提交 Pull Request

相关链接

• Mini 脚本语言 - Mini 语言主项目
• VSCode 扩展开发文档

---

Happy Coding!