# VS Code 运行说明

本说明适用于 `Windows + VS Code + MinGW-w64` 环境。

## 1. 推荐环境

建议已安装：

- VS Code
- Microsoft C/C++ 扩展
- PowerShell
- MinGW-w64
- `g++.exe`
- `gdb.exe`
- `windres.exe`

## 2. 正确打开方式

请直接用 VS Code 打开项目根目录，也就是包含以下内容的目录：

- `build-mingw.ps1`
- `.vscode/`
- `src/`
- `assets/`

不要只打开 `src/` 子目录，否则：

- 构建任务不可用
- 调试配置不可用
- 路径和资源引用可能失效

## 3. 构建方法

### 方法一：快捷键

按 `Ctrl + Shift + B`

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

### 方法二：运行任务

打开命令面板，执行：

```text
Tasks: Run Task
```

然后选择：

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

## 4. 调试方法

按 `F5`，选择：

```text
Debug Tetris MinGW
```

该配置会先构建，再启动：

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

## 5. 输出位置

构建成功后，程序位于：

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

中间产物位于同一目录下，例如：

- `Tetris.utf8.rc`
- `Tetris.res.o`

## 6. 推荐命令

在 VS Code 终端中，也可以直接执行：

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

如果构建后要立即运行：

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

## 7. 常见问题

### 1）提示找不到 `g++.exe`

说明 MinGW 没有正确安装，或者没有加入系统 `PATH`。

处理方式：

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

### 2）提示找不到 `windres.exe`

说明资源文件无法编译进程序。

结果通常是：

- 主体代码可能还能编译
- 但图标、菜单等资源会出问题

### 3）提示 `Tetris.exe: Permission denied`

通常是因为游戏程序还在运行，导致链接器无法覆盖旧的 `exe`。

处理方式：

- 先关闭正在运行的游戏窗口
- 再重新执行构建

### 4）按 `F5` 无法调试

一般是因为：

- 没安装 `gdb.exe`
- 打开的不是项目根目录
- VS Code 没有加载 `.vscode` 配置

## 8. 资源说明

项目运行依赖以下资源目录：

- `assets/icons/`
- `assets/images/`
- `assets/audio/`
- `assets/video/`

如果只是拷贝 `exe` 而不带资源目录，部分功能会缺失，例如：

- 背景图
- 背景音乐
- 复活视频

## 9. 适用场景

如果你主要在本机开发、调试和演示，VS Code 是本项目最推荐的运行方式。当前任务配置、构建脚本和资源处理流程都已经围绕 VS Code 配好。