Files
squirrelVsis/INSTALL_GUIDE.md
2025-09-17 10:54:25 +08:00

100 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 Squirrel NUT Explorer - 安装和使用指南
## 📦 已修复版本特性
**修复了所有代码错误检测的误报问题**
- 字符串检测不再误报
- 括号检测不再误报
- 智能语法检查
- 快速错误修复
**完整的功能支持**
- 代码自动完成
- 悬停信息显示
- 定义跳转
- 函数签名帮助
- 代码格式化
- 错误检测和修复
## 📋 安装步骤
### 方法一:通过 VSIX 文件安装 (推荐)
1. **打开 VS Code**
2. **打开扩展面板**
- 快捷键:`Ctrl+Shift+X`
- 或点击左侧活动栏的扩展图标
3. **安装扩展**
- 点击扩展面板右上角的 "..." 菜单
- 选择 "从 VSIX 安装..."
- 浏览并选择:`squirrel-nut-explorer-1.0.1.vsix`
4. **重启 VS Code**
- 安装完成后重启 VS Code 以确保扩展正常工作
### 方法二:命令行安装
```bash
code --install-extension squirrel-nut-explorer-1.0.1.vsix
```
## 🎯 使用方法
1. **激活扩展**
- 扩展会在 VS Code 启动时自动激活
- 在活动栏中会看到 "Squirrel" 图标
2. **连接到 pvfUtility**
- 确保 pvfUtility 服务正在运行
- 点击 Squirrel 面板中的"连接到 pvfUtility"按钮
- 连接成功后即可使用所有功能
3. **编辑 NUT 文件**
- 打开或创建 `.nut` 文件
- 享受完整的语言支持功能
## 🔧 功能说明
### 代码错误检测
- **实时检测**:输入时即时显示错误
- **智能识别**:不会误报正常的字符串和括号
- **快速修复**:点击灯泡图标或 `Ctrl+.` 应用修复
### 代码自动完成
- **关键字完成**Squirrel 语言关键字
- **函数完成**:内置和自定义函数
- **变量完成**:当前作用域的变量
- **跨文件完成**:其他 NUT 文件中的函数
### 悬停信息
- **函数说明**:显示参数、返回值和描述
- **类信息**:显示类的方法和属性
- **跨文件信息**:其他文件中的函数信息
### 其他功能
- **定义跳转**`F12``Ctrl+点击`
- **格式化代码**`Shift+Alt+F`
- **函数签名提示**:输入函数参数时显示
- **输入时格式化**:输入 `)``;``}` 时自动格式化
## 🐛 问题反馈
如果遇到任何问题,请检查:
1. VS Code 版本是否为 1.99.0 或更高
2. pvfUtility 服务是否正常运行
3. 文件扩展名是否为 `.nut`
## 📄 更新日志
### v1.0.1 (修复版)
- ✅ 完全修复字符串检测误报问题
- ✅ 完全修复括号检测误报问题
- ✅ 改进语法错误检测精度
- ✅ 增强快速修复功能
- ✅ 优化性能和稳定性
---
**享受无误报的 Squirrel 开发体验!** 🎉