Getting Started

快速入门

从安装到第一次运行，按下列步骤即可上手 Y++。

  1. 安装 IDE

    在官网下载页按架构获取 YStudio-v4-x32_setup.zip 或 YStudio-v4-x64_setup.zip（当前版本 v4.0.2.0），解压后运行其中的安装程序完成安装。

    需要编译、调试或发布程序时，再下载同一份编译器，按包内说明放到 IDE 的 toolchain 目录。

    已安装用户升级：打开 IDE → 帮助 → 检查更新，确认后在线下载并自动重启。

    YStudio 欢迎页
    启动后进入欢迎页，可创建或打开工程

    前往下载 →

  2. 创建或打开工程

    欢迎页可「创建窗口项目」或打开已有工程。新建后的目录大致为：

    • *.ysproj — 工程文件（名称、架构等）
    • 源代码/ — main.yc（事件逻辑）、global.yc / constants.yc；可再建 .yt / .ypp / .yp
    • 窗口/主窗口/主窗口.xml — 窗体布局；可再有同目录或 资源/ 下的 .yss
    • 资源/ — 图片、样式、可嵌入文件；代码里写 :/…

    完整说明见 工程结构。

  3. 设计窗体

    从工具箱拖入按钮、标签、文本框等控件，在属性面板调整标题、尺寸与布局。切到「设计」页即可预览窗体。

  4. 写中文逻辑

    Y++ 使用中文关键字，代码块用大括号 { }。语法速览见 语言基础。

    // 主窗口.yc
函数 主窗口.创建() {
    标签1.标题 = "欢迎使用 Y++"
}

函数 按钮1.被单击() {
    如果 (文本框1.内容 == "") {
        信息框("请输入内容")
        返回()
    }
    标签2.标题 = 文本框1.内容
}

  5. 运行与调试

    确认已安装编译器后，按 F5 运行。可设断点、查看调用栈与变量监视。停止用 Shift+F5。

  6. 发布

    菜单中的「发布打包」可导出用户可运行的程序目录。若使用浏览器控件，请为用户准备 WebView2 运行时。

  7. 再进一步：文件与接口

    保存文本、请求接口是常见下一步。更完整写法见 语言基础 与文档中的 HTTP / JSON 章节。

    // 写出 / 读回本地文本
写出文件("备注.txt", 文本框1.内容)
文本框1.内容 = 读文件("备注.txt")

// 取接口并解析 JSON
HTTP类 http
文本 正文 = http.提交("GET", "https://httpbin.org/get")
JSON类 j
j.解析(正文)