Blitz3D 0.9.4

Blitz3D语言支持扩展：增强您的BlitzBasic编程体验

致敬Blitz3D的创作者Mark Sibly，他的离世让我们深感遗憾，愿他安息。

本扩展为BlitzBasic语言提供语言支持，并增强Blitz3D程序及其blitzcc编译器的使用。基于Blitz Research Ltd发布的zlib/libpng许可下的原始Blitz3D源代码，实现了独立的解析和类型检查。

注意： 这是预发布版本，您可能会遇到比平常更多的bug。请通过GitHub仓库报告bug或提出功能请求，帮助开发。

发布说明

• 自动版本检测
• 支持Blitz3D 1.118

功能

扩展提供了以下功能：

• 语法高亮
• 语法错误报告
• 语义高亮
• 部分语义警告和错误（开发中）
• 基本的IntelliSense建议
• 文档符号树
• 签名帮助
• 使用内置调试器GUI
• 添加文档功能
• 在launch.json中设置默认运行文件
• 每次保存时可以看到第一个编译错误
• 浏览内置代码示例的命令
• 基本文档格式化

注意： 扩展使用Blitz3D的Windows默认编译器。由于其限制，无法提取运行时错误信息。这并非功能损失，因为默认IDE的行为类似。

BBDoc：类似javadoc的文档实用程序

BBDoc帮助更有效地编写代码，通过添加一些关键字，而不影响兼容性。

函数文档

可以在函数定义前的行使用以下关键字：

• ;; 后跟函数的文档
• ;;param 后跟参数名称及其描述
• ;;author 后跟函数的作者
• ;;return 后跟函数的返回值
• ;;since 后跟函数创建的版本
• ;;deprecated，可选地后跟理由或替代方案

这些关键字在标准blitz3d中被解释为注释，但在vscode中用于在鼠标悬停或代码完成时提供信息。

类型文档

可以在类型定义前的行使用以下关键字：

• ;; 后跟类型的文档
• ;;author 后跟类型的作者
• ;;since 后跟类型创建的版本

使用TODO管理任务

在代码中的任何位置使用;;TODO来在vscode的问题窗口中创建任务链接。这可以在扩展设置中禁用。

无需关键字解释的信息

在全局、局部、常量或字段声明后的注释被解释为描述，这些描述将显示在代码完成窗口中。

扩展设置

请查看功能贡献选项卡中的贡献设置。

已知问题和限制

• 当文件名未明确指定时，可能无法识别包含文件
• 不支持多个打开的文件夹，它们可能会错误地相互碰撞
• 如果有多个同名对象（如函数和类型），悬停时提供的信息可能不正确
• 目前类型检查有限