Tereis/VSCode运行说明.md

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 中打开项目根目录，也就是包含以下文件和目录的位置：

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

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

3. 使用 VS Code 任务构建

按：

Ctrl + Shift + B

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

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

Tasks: Run Task

然后运行：

• build Tetris MinGW
• run Tetris MinGW

4. 使用命令行构建

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

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

构建后直接运行：

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

5. 调试

按 F5，选择：

Debug Tetris MinGW

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

.vscode-build\mingw\Tetris.exe

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

6. 构建输出

最终程序：

.vscode-build\mingw\Tetris.exe

构建中间文件：

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

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

7. 资源文件

项目运行依赖：

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