Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Aquarius Language (繁體中文 / English)New to Visual Studio Code? Get it now.
Aquarius Language (繁體中文 / English)

Aquarius Language (繁體中文 / English)

aquariuslang

|
72 installs
| (0) | Free
Bilingual Traditional Chinese and English Aquarius language support: highlighting, snippets, diagnostics, completion, hover, and definitions.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Aquarius Language (繁體中文 / English) for Visual Studio Code

Edit .aqua files with bilingual Traditional Chinese / English syntax highlighting, bracket pairing, comment toggling, snippets, and a bundled Language Server Protocol server. The server provides live syntax and type-annotation diagnostics, keyword/builtin/local and module-member completion, hover documentation (with the parameters of every built-in and portable-module function, such as 陣列.排序(陣列, 比較?)), signature help while typing a call, definitions, and an outline of variables, functions, parameters, structs and fields. Chinese, English and mixed syntax work in the same file, including var, function, return and else if / elif. Chinese and other Unicode names are supported. English snippet triggers emit English syntax; Chinese triggers emit Chinese syntax. The legacy let / fn snippet triggers also expand to Chinese declarations; they are not Aquarius keywords.

Install the packaged extension

  1. Install desktop Visual Studio Code.

  2. Install the .NET 8 runtime (or a newer .NET runtime). The SDK is only needed to build from source. On Windows, use the .NET Runtime installer matching your architecture; the Desktop and ASP.NET runtimes are not required.

  3. In VS Code's Extensions view, select … → Install from VSIX… and choose aquariuslang-tw-0.1.6.vsix. You can also install from a terminal:

    code --install-extension "editors\vscode\aquariuslang-tw-0.1.6.vsix"
    
  4. Open a folder you trust and open or create a UTF-8 .aqua file. The status bar should show Aquarius (繁體中文 / English). If needed, click the language name and select it. For other folders, the installed extension activates automatically for .aqua files.

  5. Try the example below. Ctrl+Space offers completion, hovering over 加法 shows its parameters, F12 goes to its declaration, and deleting the 0 in the first line shows an error in the Problems panel. Snippet triggers include 變數, 函式, 如果, 迴圈, 印出 and their English equivalents.

變數 計數 = 0;
變數 加法 = 函式(甲, 乙) {
    回傳 甲 + 乙;
};
印出(加法(計數, 2));

The bundled server is portable across Windows, macOS, and Linux with a compatible .NET runtime. In WSL, SSH, or a development container, install the extension and .NET runtime on the remote host where VS Code runs workspace extensions.

Build and package from source

Install .NET 8 SDK, Node.js 20+ and npm. From the repository root:

dotnet build compiler/AquariusLanguageServer/AquariusLanguageServer.csproj -c Release
cd editors/vscode
npm ci
npm run check
npm run package

npm run package publishes the server into server/, bundles the client into dist/extension.js, and creates aquariuslang-tw-0.1.6.vsix in this directory. It does not publish anything to the Marketplace. The generated DLLs and VSIX are ignored by Git; rebuild them after changing server code. build-release.ps1 at the repository root runs these steps for every release and copies the VSIX, with its SHA-256, into dist/releases/.

For extension development, open editors/vscode as a VS Code folder, run npm ci, and press F5. The provided launch task builds the client and server and opens an Extension Development Host. Open an .aqua file there.

For a custom server build, set these user/machine settings if needed:

{
  "aquarius.dotnetPath": "C:\\Program Files\\dotnet\\dotnet.exe",
  "aquarius.serverPath": "D:\\src\\AquariusLangTW\\compiler\\AquariusLanguageServer\\bin\\Release\\net8.0\\AquariusLanguageServer.dll",
  "aquarius.trace.server": "off"
}

Leave aquarius.serverPath empty to use the bundled server. The extension and the server share the AquariusLang version (versioning); a server of another release shows a warning, since it may not know this release's syntax. On macOS/Linux use absolute paths appropriate to that host. Paths may contain spaces.

Run a program

Editor language support does not run or debug programs. Run them with the aqua command of an AquariusLang distribution, or a repository build of compiler/AquariusCli with runtime packs from scripts/build-runtime.ps1:

aqua run examples/increment.aqua

The language server lists library modules from the runtime of the installation it finds: AQUARIUS_HOME, the aqua on PATH, or the repository it was built in.

Tests

From the repository root:

dotnet test compiler/AquariusTests --filter FullyQualifiedName~LanguageServer

The protocol tests (compiler/AquariusTests/languageserver) launch the actual server and cover lifecycle, byte framing, Unicode positions, scopes, edits, diagnostics, malformed/incomplete input, and every repository example.

After npm run vscode:prepublish, the extension can also be tested with an installed VS Code, from this directory:

code --extensionDevelopmentPath="$PWD" --extensionTestsPath="$PWD/test/extension-host.js" --user-data-dir="$env:TEMP/aquarius-vscode-test" --extensions-dir="$env:TEMP/aquarius-vscode-test-extensions" --disable-extensions --disable-workspace-trust

This uses a separate test profile and checks completion, hover, definitions, outline, live diagnostic updates, and restarting the server. It does not install the extension in your normal profile.

Troubleshooting and current limits

  • If features fail to start, run dotnet --list-runtimes, restart VS Code after installing .NET, and check View → Output → Aquarius Language Server. Run Aquarius: Restart Language Server from the Command Palette after fixing settings. Setting aquarius.trace.server to verbose records protocol traffic.
  • Syntax highlighting and snippets work in an untrusted workspace; the server starts after you trust it. Runtime analysis only parses source and never executes it or imports modules.
  • Diagnostics report syntax/lexical errors and the mistakes the compiler rejects in annotated code (type mismatches, unknown struct fields). Dynamic type errors, undefined names, and runtime errors remain the runtime's responsibility.
  • Completion and definitions resolve declarations in the current document's function and loop scopes. Imported module members and cross-file navigation are not yet implemented. Static visibility follows source order and cannot model every dynamic closure or conditional declaration.
  • Extremely deep expressions are limited to 256 levels to keep incomplete or pathological source from crashing the server. No formatter, rename provider or debugger is included in this version.

The implementation follows Microsoft's LSP 3.17 specification and VS Code language-server extension guide.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft