# VS Code 运行说明

本项目推荐使用 `VS Code + MinGW-w64 + PowerShell` 构建和调试。

## 1. 环境准备

需要安装：

- Visual Studio Code
- Microsoft C/C++ 扩展
- MinGW-w64
- PowerShell

MinGW 中至少需要：

- `g++.exe`
- `windres.exe`
- `gdb.exe`，仅调试时需要

## 2. 打开项目

请在 VS Code 中打开项目根目录，也就是包含以下文件和目录的位置：

```text
build-mingw.ps1
src/
assets/
.vscode/
README.md
```

不要只打开 `src/` 子目录，否则 VS Code 任务和调试配置无法正常工作。

## 3. 使用 VS Code 任务构建

按：

```text
Ctrl + Shift + B
```

默认会执行项目中的 MinGW 构建任务。

也可以打开命令面板，选择：

```text
Tasks: Run Task
```

然后运行：

- `build Tetris MinGW`
- `run Tetris MinGW`

## 4. 使用命令行构建

在 VS Code 终端中进入项目根目录，执行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
```

构建后直接运行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
```

## 5. 调试

按 `F5`，选择：

```text
Debug Tetris MinGW
```

调试配置会先构建项目，再启动：

```text
.vscode-build\mingw\Tetris.exe
```

如果提示找不到 `gdb.exe`，说明 MinGW 的调试器没有安装或没有加入 `PATH`。

## 6. 构建输出

最终程序：

```text
.vscode-build\mingw\Tetris.exe
```

构建中间文件：

```text
.vscode-build\mingw\Tetris.utf8.rc
.vscode-build\mingw\Tetris.res.o
```

这些中间文件不需要手动维护。

## 7. 资源文件

项目运行依赖：

```text
assets/icons/
assets/images/
assets/audio/
assets/video/
```

如果只移动 `Tetris.exe` 而不带 `assets/`，会影响背景图、音乐和视频复活功能。

## 8. 常见问题

### 找不到 `g++.exe`

处理方式：

- 将 MinGW 的 `bin` 目录加入系统 `PATH`
- 或将 MinGW 安装到 `C:\mingw64\bin\`

### 找不到 `windres.exe`

资源文件无法编译，图标和菜单资源可能缺失。请检查 MinGW 安装是否完整。

### `Tetris.exe: Permission denied`

说明程序正在运行，构建时无法覆盖旧 exe。

处理方式：

1. 关闭游戏窗口
2. 重新构建

### 鼠标点击、按钮或界面不是最新版

通常是因为构建失败后仍在运行旧 exe。请确认构建命令成功完成。

## 9. 推荐运行流程

1. 打开项目根目录
2. 关闭旧的游戏窗口
3. 执行构建
4. 运行 `.vscode-build\mingw\Tetris.exe`
5. 如果要调试，按 `F5`