工程结构

新建「窗口项目」后，YStudio 会在所选位置创建与项目同名的目录。本文说明默认文件布局与常见扩展。

相关：窗口 XML · YSS · 资源嵌入 · 自定义类型 · 自定义类 · DLL / API

默认目录树

{工程名}/
  {工程名}.ysproj          # 工程描述（JSON：名称、架构、类型等）
  源代码/
    main.yc                # 主逻辑 / 控件事件（新建时自动生成）
    global.yc              # 全局变量（新建时自动生成）
    constants.yc           # 全局常量（新建时自动生成）
    *.yt / *.ypp / *.yp    # 按需：自定义类型 / 类 / API 声明
  窗口/
    主窗口/
      主窗口.xml           # 主窗布局与控件属性
      主窗口.yss           # 可选，与 XML 同目录的样式
    {其它窗}/
      {其它窗}.xml
      {其它窗}.yc          # 次级窗事件源（可与主逻辑并列）
  资源/
    {窗体名}.yss           # 推荐的 YSS 位置（F5 会部署到 exe 旁）
    img/ …                 # 图片、脚本、数据等；代码中写 :/相对路径
  发布/                    # 编译 / 发布输出（运行后生成，勿手改为源）

文件类型

扩展名	用途
.ysproj	工程文件；双击或「打开工程」用
.xml	窗体布局；设计器读写
.yc	Y++ 源码：事件、函数、业务逻辑
.yss	界面样式表（类 CSS）
.yt	自定义类型（值语义结构体）
.ypp	自定义类
.yp	DLL / 系统 API 声明

在工程树 源代码 上右键可新建 .yc / .yt / .ypp / .yp；新建窗口会在 窗口/{窗体名}/ 下生成对应 XML（及可选 YSS）。

新建时自动生成的内容

路径	说明
{工程名}.ysproj	type=window，含架构（x86 / x64）等
源代码/main.yc	事件处理入口；注释里有简易示例
源代码/global.yc	放全局变量
源代码/constants.yc	放全局常量
窗口/主窗口/主窗口.xml	空白主窗（默认约 420×280）
资源/	空目录，用于图片、YSS、嵌入文件等

写代码时怎么找文件

1. 改界面 → 打开 窗口/{窗体名}/{窗体名}.xml（设计视图），或从工程树点窗体节点。
2. 写事件 → 主窗逻辑多在 源代码/main.yc；次级窗可在 窗口/{窗体名}/{窗体名}.yc。
3. 写样式 → 推荐 资源/{窗体名}.yss；也可放在窗口同目录。运行时默认加载 exe 旁 {窗体名}.yss。
4. 读资源 → 统一写成 :/相对资源路径（相对工程「资源」目录），详见 资源嵌入。

多窗口

新建窗口后目录形如 窗口/登录/、窗口/工作台/。每个窗口可有自己的 XML、YSS 与事件源。跨窗操作与 载入 / 关闭 见 多窗口设计。