pLang for Visual Studio Code

pLang 语言的 VS Code 扩展 —— 提供完整的语言支持、IntelliSense、构建与调试能力。

功能

• 语法高亮：关键字、类型、字符串、注释、数字、运算符（TextMate 语法 + 语义着色）
• IntelliSense（基于 lsp-server）：
  • 悬停、跳转定义（F12）、查找引用（Shift+F12）、重命名（F2）
  • 代码补全（含成员补全 io.）、文档符号（大纲）、语义着色
  • 实时诊断：编译错误显示在「问题」面板
• 构建与运行：一键生成、运行、生成并调试活动文件（基于 plc 编译器）
• 调试：基于 LLDB 的 pdb 调试器，支持断点、单步、变量、监视、求值，程序输出显示在调试控制台
• 配置：.vscode/plang_properties.json（JSON Schema 校验 + 可视化编辑 UI）
• 引用视图：侧边栏展示查找引用结果
• SSH 目标：在远程主机上构建/运行（可选）
• 代码片段：函数、结构体、流程控制等常用模板
• 入门向导：欢迎页 Walkthrough 引导配置环境

安装

从 VS Code 市场安装，或：

npm install
npm run package    # 生成 plang-vscode-*.vsix
code --install-extension plang-vscode-1.0.0.vsix

工具链

扩展需要 pLang 工具链（详见 walkthrough/installcompiler/install-plang-compiler.md）：

组件	作用
plc	pLang 编译器
lsp-server	语言服务器（LSP over stdio）
pdb	调试器（DAP，基于 LLDB）

扩展自动探测路径；也可通过设置 plang.compilerPath / plang.lspServerPath / plang.debuggerPath 指定。

快速开始

1. 打开包含 .plang 文件的文件夹
2. 编辑代码，体验 IntelliSense
3. 点击编辑器右上角 ▶ 运行，或 ▶▶ 生成并调试

常见命令

命令	说明
pLang: 生成并调试活动文件	编译 + 调试当前文件
pLang: 生成活动文件	编译当前文件
pLang: 运行活动文件	编译并运行
pLang: 编辑配置 (UI)	可视化编辑 plang_properties.json
pLang: 选择配置	切换 IntelliSense 配置
pLang: 重置 IntelliSense 数据库	重启语言服务器
pLang: 输出诊断信息	输出工具链探测结果

许可

MIT