tsl-devkit/vscode/README.md

TSL Tools for VSCode

强大的 TSL 语言开发工具集
为 VSCode 提供完整的 TSL 语言支持

✨ 功能特性

• 🎨 语法高亮 - 基于 TextMate 语法的智能代码着色
• 🔧 语言服务器协议 (LSP) - 提供智能代码补全、错误检查、跳转定义等功能
• 📝 代码片段 (Snippets) - 快速插入常用代码模板

📦 安装方式

方式一：通过 VSIX 文件安装（推荐）

直接使用预编译的扩展包：

# 命令行安装
code --install-extension tsl-tools-3.0.0.vsix

或者在 VSCode 中：

1. 打开命令面板 (Ctrl+Shift+P / Cmd+Shift+P)
2. 输入 Install from VSIX
3. 选择 tsl-tools-3.0.0.vsix 文件

方式二：从源码构建

# 克隆仓库
git clone https://git.mytsl.cn/csh/tsl-devkit.git
cd tsl-devkit

# 安装依赖
npm install

# 打包扩展
npx vsce package

# 安装生成的 VSIX 文件
code --install-extension tsl-tools-3.0.0.vsix

方式三：手动安装

将扩展文件夹复制到 VSCode 扩展目录：

操作系统	扩展目录路径
Windows	%USERPROFILE%\.vscode\extensions
macOS	~/.vscode/extensions
Linux	~/.vscode/extensions

⚙️ 配置选项

在 VSCode 设置中配置 TSL 扩展：

语言服务器配置

配置项	类型	默认值	描述
tsl.server.executable	string	""	TSL 语言服务器可执行文件路径 留空自动检测
tsl.server.arguments	string[]	["--log=trace", "--log-stderr"]	语言服务器启动参数 使用 ./tsl-server --help 查看所有选项
tsl.interpreter.executable	string	""	TSL 解释器路径 用于识别 funcext 下的 .tsf 文件

配置示例

{
  "tsl.server.executable": "/usr/local/bin/tsl-server",
  "tsl.server.arguments": ["--log=info", "--log-stderr"],
  "tsl.interpreter.executable": "/usr/local/bin/tsl"
}

⚠️ 注意: tsl.interpreter.executable 与服务器参数 --interpreter=PATH 冲突，请只使用其中一个