言序语言 · VS Code

言序编程语言的官方 VS Code 扩展。

当前扩展版本为1.2.0，支持言序核心1.1.4及兼容的 1.x 版本。扩展会索引工作区、递归导入的外部模块和当前 CLI 的标准库，并为全部用户声明提供跨文卷补全、导航与拼音检索；核心语言和 CLI 无需改动。

功能

• .yx 文卷语法高亮；
• 中文引号、括号自动配对与代码折叠；
• 块结构、分支、错误处理、协议和文档注释的智能缩进；
• 变量、流程、函数、类、父类调用、类型判断、协议、泛型、异步任务、网络、模块、元组和切片代码片段；
• 编辑器右上角一键运行当前文卷；
• 1.0 LSP 实时诊断、补全、跳转、引用、重命名、悬停、文档符号与全文格式化；
• 索引类、协议、字段、方法、函数、参数、变量、常量和导入别名，未保存的编辑会增量更新；
• 递归索引引「相对路径」和引「包:名称」引用的工作区内外模块；包导入只读解析已有清单、锁文件与本地缓存，仅向使用方暴露模块的公有声明；
• 从yanxu 标准库 --json读取当前安装版本的标准库模块与成员，命令不可用时使用随扩展发布的快照；
• 在代码补全和“转到工作区中的符号”中支持中文、无声调全拼和拼音首字母，例如jisuanzonghe或jszh可找到计算总和；
• 为索引符号提供成员补全、悬停、参数提示和跨文卷定义跳转，标准库定义可在只读虚拟文卷中查看；
• LSP 不可用时仍提供基础补全、悬停说明和内建函数签名提示；
• VS Code“运行和调试”中的源码断点、继续、单步、调用栈与作用域变量；
• 静态检查、字节码 VM、执行踪迹与工作区测试命令；
• 一键调用 yanxu 迁 --写 更新当前文卷中的弃用语法；
• 在可复用 REPL 中运行选区或当前行；
• 状态栏显示语言服务状态，并可一键重启或查看通信日志；
• 自动发现“运行、检查、VM、踪迹、测试、迁移”六类 VS Code 任务；
• 一键调用yanxu 迁 --写迁移当前文卷中的已弃用形式；
• 命令面板打开言序 REPL 或在线文档。

使用

请先安装言序命令行，然后打开任意 .yx 文件。默认会从 PATH 查找 yanxu；若安装在其他位置，请设置 yanxu.executablePath。

打开命令面板并输入“言序”即可查看所有命令。编辑器右键菜单可以运行当前文卷或把选中代码送入 REPL；“终端 → 运行任务”中可以直接选择言序任务。打开.yx后可在行号左侧设置断点，再从“运行和调试”选择“调试当前言序文卷”。

设置

索引会随文卷创建、修改、保存和删除自动更新。依赖或外部模块大规模变化后，可从命令面板运行“言序：重建符号索引”。

自动发布

每次提交或 Pull Request 都会运行结构校验、单元测试和 VSIX 打包。更新package.json与package-lock.json版本、加入同版本变更记录并推送到main后，Auto Release会自动创建v*标签，再由可复用Release工作流创建 GitHub Release 并上传 VSIX；仓库设置了VSCE_PAT Secret 时，还会同步发布到 VS Code Marketplace。已有标签也可从 Actions 手工重跑发布。

问题反馈

请在扩展仓库报告问题。语言问题请提交到语言核心仓库。

完整文档位于 Fumadocs 文档站。