# EasyXTemplate

**Repository Path**: samuel1971/easyx-template

## Basic Information

- **Project Name**: EasyXTemplate
- **Description**: EasyX Template 的vscode插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-14
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyX Template for VSCode

这是一个VSCode扩展，用于快速创建EasyX图形库项目模板。

## 功能特性

- 🚀 **快速创建项目**: 一键创建完整的EasyX项目结构
- 📝 **包含示例代码**: 提供带有中文注释的EasyX示例代码
- ⚙️ **完整配置**: 自动生成VSCode配置文件，包括调试设置
- 🛠️ **多种编译方式**: 支持VSCode任务、批处理文件和命令行编译
- 📚 **详细文档**: 自动生成项目README文件，包含使用说明

## 安装要求

在使用此扩展前，请确保您的系统已安装：

1. **VSCode** (版本 1.106.0 或更高)
2. **TDM-GCC 编译器** (推荐版本)
3. **EasyX 图形库** ([下载链接](https://easyx.cn))

## 安装步骤

1. 打开VSCode
2. 按 `Ctrl+Shift+X` 打开扩展市场
3. 搜索 "EasyXTemplate"
4. 点击安装

或者从本地安装：
1. 下载扩展源码
2. 在扩展目录下运行 `npm install`
3. 按 `F5` 启动调试扩展

## 使用方法

### 创建新项目

1. 打开命令面板（`Ctrl+Shift+P`）
2. 输入 "Create EasyX Project"
3. 按照提示输入项目名称
4. 选择项目保存位置
5. 选择是否立即打开项目

### 项目结构

创建的EasyX项目包含以下文件：

```
MyEasyXProject/
├── main.cpp                    # 主程序文件（包含示例代码）
├── compile_and_run.bat        # 编译运行脚本
├── README.md                   # 项目说明文档
└── .vscode/                   # VSCode配置目录
    ├── tasks.json             # 任务配置
    ├── launch.json            # 调试配置
    ├── c_cpp_properties.json  # C/C++配置
    └── settings.json          # 编辑器设置
```

### 编译和运行

#### 方法一：VSCode任务 (推荐)
1. 按 `Ctrl+Shift+P` 打开命令面板
2. 输入 "Tasks: Run Task" 并选择
3. 选择 "编译EasyX项目" 来编译代码
4. 选择 "编译并运行EasyX项目" 来编译并运行程序

#### 方法二：调试模式
1. 按 `F5` 开始调试
2. 程序会自动编译并启动调试

#### 方法三：批处理脚本
双击运行 `compile_and_run.bat` 文件

#### 方法四：命令行
```bash
# 编译
g++ -g main.cpp -o main.exe -leasyx -lgdi32 -lole32 -static-libgcc -static-libstdc++

# 运行
main.exe
```

## 配置说明

### 编译器配置
默认配置假设您安装了TDM-GCC编译器。如果您的编译器路径不同，请修改：

**`.vscode/c_cpp_properties.json`:**
```json
{
    "configurations": [
        {
            "compilerPath": "您的编译器路径",
            "includePath": [
                "您的包含路径"
            ]
        }
    ]
}
```

**`.vscode/tasks.json`:**
修改任务中的编译器路径和链接库路径。

### EasyX库路径
如果编译器找不到EasyX库，请确保：
1. EasyX库已正确安装
2. 编译器路径配置正确
3. 链接库参数包含 `-leasyx`

## 示例代码

创建的示例代码包含：
- 图形窗口初始化
- 基本图形绘制（圆、矩形、椭圆等）
- 颜色设置和文字输出
- 键盘输入处理

## 故障排除

### 编译错误
- **找不到easyx库**: 检查EasyX是否正确安装，编译器路径是否正确
- **链接错误**: 确认链接库参数包含 `-leasyx -lgdi32 -lole32`

### 运行时错误
- **程序无法启动**: 确保有图形界面支持，检查exe文件是否生成
- **调试问题**: 检查`.vscode/launch.json`中的配置

### VSCode配置问题
- **智能提示不工作**: 检查`.vscode/c_cpp_properties.json`配置
- **任务无法运行**: 确保安装了C/C++扩展

## 开发信息

### 项目结构
- `src/extension.ts` - 扩展主文件
- `src/templates/` - 项目模板文件
- `package.json` - 扩展配置

### 贡献
欢迎提交Issue和Pull Request来改进这个扩展！

### 许可证
本项目采用MIT许可证。

## 更新日志

### v0.0.1
- 初始版本发布
- 支持创建基础EasyX项目模板
- 包含完整的VSCode配置
- 提供多种编译运行方式

## 联系方式

如果您遇到问题或有建议，请在GitHub上提交Issue。

**祝您使用愉快！** 🎉