Tooling

Norm 的 formatter、诊断和编辑器能力读取与编译器相同的语义快照。类型检查、名称解析和项目边界只实现一次。

当前能力

• 格式化与编译器诊断；
• 作用域和期望类型驱动的补全；
• Signature Help 与 Hover；
• 跳转定义与查找引用；
• Prepare Rename 与语义 Rename；
• 跨文件、跨 package 和标准库源码导航；
• 未保存文档参与项目分析。

结构化 API 文档复用同一语义入口，见 API 文档导出。自包含应用的输出约定见应用构建。

从示例开始

使用开发版工具链，在空目录中运行 norm hello，生成五个独立的 .norm 程序以及英文、中文说明。先运行 norm hell.norm，再按生成的示例说明继续体验。

norm run main.norm 默认不显示启动准备日志。使用 norm run --debug main.norm，将启动阶段、累计耗时和实际 Maven 下载写入 stderr；错误诊断始终显示，应用输出不受此选项影响。进度入口见 RunCommand，本地依赖的联网边界验证见 JarResolverTest。

VS Code

AI Agent 的规范、查询和验证导航见 Agent 开发入口。

正式 VSIX 包含受支持平台的同版本自包含 CLI。安装、运行、项目识别和 CLI 选择见 VS Code 开发体验。发布资产与平台矩阵见发布流程。

共同语义入口

Source files
  → Project source set
  → Semantic model
  → diagnostics / completion / signatures
  → hover / navigation / references / rename
  → formatter / compiler

工具能力的当前交付边界见 Status。调试器和在线执行环境尚未进入发布版。