VSCode for Ballerina：云原生编程语言

需安装Ballerina官方VS Code扩展、配置Ballerina SDK运行时环境、创建云服务模块、启用调试会话，并集成Docker构建推送支持。

如果您希望在 Visual Studio Code 中高效开发 Ballerina 语言程序，则需要配置专用的编辑器支持环境。Ballerina 是一种面向云原生应用设计的编程语言，其语法与工具链深度集成于 VSCode。以下是实现该目标的关键步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装 Ballerina VS Code 扩展

VS Code 通过扩展机制提供 Ballerina 的语法高亮、代码补全、调试支持和项目初始化功能。官方扩展由 Ballerina 团队维护，确保与最新语言版本兼容。

1、启动 VS Code，点击左侧活动栏中的扩展图标（或按快捷键 Ctrl+Shift+X）。

2、在扩展搜索框中输入 Ballerina，找到名称为 “Ballerina” 的官方扩展（发布者为 ballerina-platform）。

3、点击“安装”按钮，等待扩展下载并启用完成。

4、重启 VS Code 以确保所有语言服务器组件正确加载。

二、配置 Ballerina 运行时环境

Ballerina 扩展依赖本地 Ballerina 命令行工具（CLI）执行编译、运行与测试操作。扩展本身不包含运行时，必须单独安装 Ballerina SDK 并将其路径纳入系统 PATH。

1、访问 https://ballerina.io/downloads/，下载适用于 macOS 的最新稳定版 Ballerina ZIP 包。

2、解压 ZIP 文件至 /usr/local/ballerina 目录。

3、在终端中执行 echo export PATH="/usr/local/ballerina/bin:$PATH" >> ~/.zshrc，将 Ballerina CLI 添加至 shell 环境变量。

4、运行 source ~/.zshrc 使配置立即生效，并在终端中输入 bal version 验证安装成功。

三、创建首个 Ballerina 云服务模块

利用 VS Code 集成的 Ballerina 命令面板可快速生成符合云原生规范的服务模板，包括 HTTP 服务骨架、OpenAPI 文档注解及 Dockerfile 支持。

1、按下 Cmd+Shift+P 打开命令面板，在输入框中键入 Ballerina: Initialize a Ballerina Project 并回车。

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

2、选择项目类型为 Service，输入模块名称如 hello-cloud。

3、确认端口设置为 9090，并启用 OpenAPI 生成选项。

4、VS Code 将自动生成含 main.bal、Ballerina.toml 和 Dockerfile 的完整目录结构。

四、启用 Ballerina 调试会话

VS Code 的调试功能通过 Ballerina Language Server 启动调试适配器，支持断点、变量监视与调用栈导航，适用于服务端逻辑与集成测试场景。

1、在生成的服务文件 main.bal 中，于 service / on new http:Listener(9090) 行左侧灰色区域单击，设置断点。

2、点击左侧活动栏的调试图标，再点击顶部的“运行和调试”下拉菜单，选择 Launch Service 配置。

3、点击绿色三角形“开始调试”按钮，Ballerina 运行时将在终端中启动监听进程。

4、在浏览器中访问 http://localhost:9090/hello，触发断点并进入调试视图。

五、集成 Docker 构建与推送支持

Ballerina 内置容器化能力，可通过 VS Code 扩展直接调用 bal build 命令生成轻量级 OCI 镜像，并推送至远程镜像仓库，满足云原生 CI/CD 流程需求。

1、确保系统已安装 Docker Desktop 并处于运行状态。

2、在项目根目录打开集成终端，执行 bal build --cloud=docker，生成 Docker 镜像。

3、运行 docker images | grep hello-cloud 查看生成的镜像 ID。

4、登录目标 Registry 后，执行 docker tag [IMAGE_ID] your-registry/hello-cloud:latest，再运行 docker push your-registry/hello-cloud:latest。