跳到主要内容

工具与 IDE(SiiDeal)

Sii 桌面 IDE:SiiDeal。

功能概览

  • 语法高亮与主题
    • 内置 sii-dark/sii-light 主题
    • 关键字、类型、操作符、标准库 sii.* 方法高亮
  • 智能补全
    • 关键字片段:if (...) {}else {}funcclasscrob 两种写法、remake
    • 类型与常量:int/string/bool/...true/false
    • 标准库:输入 sii. 自动列出 readText/writeText/exists/...
    • 外部库:输入 cite 时自动补全库名
  • 悬浮提示(Hover)
    • 关键字/类型/操作符说明
    • sii.* 方法签名与用途
    • crob ObjName(class:..., right:...) 参数说明
    • 外部库函数签名与用途
  • 一键运行与编译
    • F5 运行(自动编译后运行)
    • F6 编译
    • 自带终端面板显示输出
  • 交互式输入
    • 运行中调用 ToGet() 时,可在底部终端直接输入内容并回车
  • 文件/项目浏览
    • 左侧资源管理器打开文件夹、创建文件/文件夹、重命名/删除
  • 设置面板
    • 字体/主题/自动保存/编辑器行为
    • Sii 环境检测与路径配置
  • 库管理支持
    • 集成 Sii CLI 库管理命令
    • 支持库的安装、更新、卸载操作

安装与启动

  • macOS: 下载 DMG,拖拽安装后从「应用程序」启动
  • Windows: 下载 zip 或安装包(nsis/portable),安装或解压后启动

首次启动建议:

  1. 在左侧资源管理器点击「打开文件夹」,选择你的 Sii 项目
  2. 右上工具栏或菜单「运行/编译」进行体验

环境配置(Sii 编译器)

  • 菜单「帮助 → 设置 → Sii 语言」
    • 自动检测:点击「自动检测 Sii 环境」
    • 手动设置:在「Sii 编译器路径」填入 sii 可执行文件绝对路径
  • macOS 常见路径(自动补全 PATH 已内置):
    • /opt/homebrew/bin/sii(Apple Silicon)
    • /usr/local/bin/sii(Intel)

提示:从 Finder 启动的应用默认 PATH 较“干净”,SiiDeal 已自动增强 PATH 并尝试解析绝对路径。

运行与交互输入

  • F5 运行会在底部终端面板显示「正在运行...」,随后输出程序结果
  • 若程序调用 ToGet() 读取输入:
    • 直接在终端输入文本并回车,输入会写入程序 stdin,程序继续执行

语法高亮与补全细节

  • 关键字:let/const/func/class/crob/remake/typeins/new/if/else/while/forloop/back/push/out/rmv/share/cite/from/Array/this/...
  • 类型:str/string/int/bool/singlef/multif/arr/class/obj/unknown/void
  • 操作符:含 => && || == != <= >=
  • 片段:
    • ifif (condition) {\n\t$0\n}
    • elseelse {\n\t$0\n}
    • crob 封装式 → crob ObjName(class:name, right:bool) {\n\t...\n}
    • crob 简单式 → crob ObjName = new ClassName();
  • 标准库 sii.:支持 readText/writeText/exists/mkdirs/pathJoin/cwd/env/now/jsonParse/jsonStringify/exec/execOut/listen/get/post/respText/respJson/respHtml/log/warn/error

快捷键

  • F5: 运行 Sii 文件
  • F6: 编译 Sii 文件
  • Ctrl/Cmd + S: 保存当前文件
  • Ctrl/Cmd + O: 打开文件;Ctrl/Cmd + Shift + O: 打开文件夹
  • 终端面板切换:界面右下角终端图标或设置中启用

设置与个性化

路径:菜单「帮助 → 设置」

  • 常规:恢复会话、欢迎页、自动保存
  • 编辑器:字体/字号、行号、小地图、缩进、换行、括号匹配
  • 主题:IDE 主题、编辑器高亮主题、主色/强调色
  • Sii 语言:编译器路径、自动编译、显示编译错误、补全/片段/悬浮

「帮助 → 关于」会显示版本与作者信息:1.0.0 By AndyJin <当前年份>

常见问题(FAQ)

  • 启动后找不到 sii
    • 在设置里手动指定编译器路径,或将 sii 放到 /opt/homebrew/bin(Apple Silicon)//usr/local/bin
  • 运行时报 where ENOENT
    • 已在内部自动将 Windows 的 where 映射为 POSIX 的 which,并处理错误;请升级至最新版本
  • 运行卡住等待输入
    • 程序中使用了 ToGet();请在底部终端输入内容并回车

反馈与支持

  • IDE 内:菜单「帮助 → 反馈与建议」
  • 官网文档与示例:见左侧文档导航

祝编码愉快!