跳转到内容

编辑器设置

VS Code 中为 .sharq 单文件组件提供语法高亮:<template> 块按 XML 高亮,<script> 按 C# (包括 $using 指令),<style> 按 CSS 高亮并支持 USS 专有属性(-unity-*)与设计令牌变量 (--sus-*);模板指令 —— v-if / v-for:prop="…"@click="…"$MainElement —— 绑定内的表达式按 C# 高亮

安装(VSIX,推荐)

  1. 下载 sharq-language-0.1.0.vsix(VSIX 发行版启动后链接将上线——现在请使用下面的手动安装)。
  2. 安装:
bash
code --install-extension sharq-language-0.1.0.vsix

或在 VS Code 中:Extensions → ⋯ 菜单 → Install from VSIX…,然后重新加载窗口。

手动安装(无需 VSIX)

  1. 下载 sharq-vscode-0.1.0.zip
  2. 解压到扩展目录,使路径为:
    • Windows:%USERPROFILE%\.vscode\extensions\sharq-it.sharq-language-0.1.0\
    • macOS / Linux:~/.vscode/extensions/sharq-it.sharq-language-0.1.0/
  3. 重启 VS Code,打开任意 .sharq 文件。

效果示例

html
<template>
<ui:VisualElement $MainElement class="home-screen">
    <ui:Label class="home-screen__title" :text="Title.Value" />
    <sus:SusButton variant="primary" text="Start" @click="Title.Value = \"Hello\"" />
</ui:VisualElement>
</template>

<script>
$using Sharq.Core;

// Props 是响应式的:运行时给 Title.Value 赋值,标签会自动更新。
public Prop<string> Title = new("Welcome to SUS");
</script>

<style>
.home-screen__card:hover {
  border-color: var(--sus-primary);
}
</style>

其他编辑器

  • Rider / JetBrains —— 暂无专用插件;将文件类型关联为 XML 时基本可用。TextMate bundle 方案在计划中。
  • Unity —— 无需设置:保存时由包自动编译 .sharq