Norm

简体中文

English

简体中文

English

外观

VS Code 开发体验 ​

Norm 的官方 VS Code 扩展包含当前版本的自包含 norm CLI。安装一个 VSIX 后即可获得语法高亮、编译器诊断、格式化、补全、导航和运行命令，不需要另行安装 Java。

安装 ​

  1. 打开 Norm 最新 Release。
  2. 下载唯一的 norm-language-support-vMAJOR.MINOR.PATCH.vsix。
  3. 在 VS Code 命令面板执行 Extensions: Install from VSIX...。
  4. 选择下载的文件，重新加载窗口。

通用 VSIX 同时包含 Windows x64、Linux x64 与 macOS ARM64 的同版本 CLI，扩展会根据当前平台选择正确的可执行文件。

如果还需要在 Windows 终端运行 norm，从同一 Release 下载 norm.exe。它可以直接执行；运行一次 norm.exe setup 会安装到当前用户并自动配置 PATH，新开终端后即可使用 norm。Linux 与 macOS 仍使用对应平台的 CLI 压缩包。不要混用不同 Release 的扩展和 CLI。

第一个文件 ​

新建 hello.norm：

norm
main() {
    String language = "Norm"
    printLine("Hello, " + language)
}

保存后可以：

  • 点击编辑器右上角的运行按钮；
  • 在命令面板执行 Norm: Run Current File；
  • 使用 Ctrl+F5，macOS 使用 Cmd+F5。

扩展会先保存当前项目中已打开的 Norm 文件，再启动程序。输出进入专用任务终端，编译错误同时显示在编辑器和 Problems 面板。

编辑器能力 ​

编写代码 ​

  • .norm 文件、关键字、类型、nullable、泛型、Annotation 与 extension function 高亮；
  • 括号、引号和缩进编辑行为；
  • 保存时使用编译器 formatter；
  • 在未完成的返回语句、变量初始化和调用参数中继续提供建议；
  • 根据期望类型和作用域排序局部值、函数、类型、enum variant 与模板。

理解类型与调用 ​

  • 参数提示显示命名参数、重载和替换后的泛型签名；
  • nullable receiver 提供 safe access 补全；
  • 容器成员按实际类型参数显示；
  • 显式导出的 extension function 可以成员式补全，并自动加入 import；
  • Class<T>、Field<Owner, Value>、Function<Signature>、Annotation 生命周期及 JSON/XML/YAML API 提供补全、悬停和跳转。

浏览项目 ​

  • 跨文件与跨 package 跳转定义、查找引用和语义重命名；
  • module export、文件私有声明和 class private 成员使用编译器可见性规则；
  • 补全其他 package 的公开声明时生成精确 import edit；
  • 诊断、导航和补全会跟随未保存的内存文档更新。

这些能力都由 norm lsp 的编译器语义快照计算。扩展不复制一套类型检查或名称解析逻辑。

在 Norm 源码仓库中编辑 norm/stdlib/std 时，Language Server 会把磁盘文件作为内置标准库同一声明身份的源码覆盖层分析；它不会再加载一个重名的用户 std 模块。

单文件与项目 ​

.norm 文件可以在同一文件中声明 module()、依赖和应用入口，本地单文件应用不要求 package、Module 名称或版本。CLI 与 Language Server 读取这份唯一声明，并从指定仓库解析依赖。多文件项目仍使用正式 package 结构和独立的根 module.norm。

模块规则见模块系统。

CLI 选择 ​

正式扩展默认使用自身包含的自包含 CLI。只有开发 Norm 工具链时，才需要设置 norm.cli.path。配置项、包内 CLI 和系统 CLI 必须与扩展版本一致；Norm 源码工作区可以使用同一 major/minor 且不旧于扩展的工作区补丁版本。不匹配的候选会被跳过，并在 Norm Language Server 输出中说明原因。状态栏持续显示实际使用的 CLI 版本，点击可查看来源和路径。

正式扩展的解析顺序是：

  1. 版本匹配的 norm.cli.path；
  2. 当前 Norm 源码工作区中同一 major/minor 且补丁版本更新的开发构建；
  3. 扩展包内同版本的自包含 CLI；
  4. 当前 Norm 源码工作区中与扩展同补丁版本的开发构建；
  5. 系统 PATH 中的同版本 norm。

通过 F5 启动扩展开发宿主时，工作区构建优先于扩展包内容。Language Server 与运行命令复用同一次选择，不会分别启动两个工具链版本。

设置路径后执行 Norm: Restart Language Server，确保窗口不再使用旧进程。

常见问题 ​

文件有高亮，但没有诊断或补全 ​

TextMate 高亮不需要语言服务器，其余功能需要 CLI。先执行 Norm: Restart Language Server；仍然失败时检查 Output 面板中的 Norm 日志，以及 norm.cli.path 是否指向当前平台可执行文件。

终端可以运行，扩展仍然使用旧版本 ​

查看状态栏中的 Norm 版本，点击可显示 CLI 路径和来源；同样的信息也会写入 Norm Language Server 输出。norm.cli.path 指向其他版本时，扩展会使用包内的匹配版本并显示一次提示。

跨文件 import 或补全缺失 ​

确认依赖已在同文件的 module() 或项目根 module.norm 中声明，目标声明是 public。单文件脚本之间不会因为处于同一目录就自动组成项目。

运行命令使用了错误目录 ​

norm.run.workingDirectory 可以选择工作区目录或当前文件目录。项目程序通常使用工作区目录，依赖同目录资源的独立脚本可以选择文件目录。

开发扩展 ​

只有修改 Norm 编译器或 VS Code 扩展时才需要源码开发包。完整构建、测试和本地 VSIX 流程以 cli/extensions/vscode/README.md 为准；发布平台、资产和验收要求以发布流程为准。

当前语言服务的精确边界见版本索引。调试器尚未进入发布版。

下一篇：语言哲学。

Norm 0.25

Norm Project