Tereis/VSCode运行说明.md

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 构建任务。

方法二：运行任务

打开命令面板，执行：

Tasks: Run Task

然后选择：

• build Tetris MinGW
• run Tetris MinGW

4. 调试方法

按 F5，选择：

Debug Tetris MinGW

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

.vscode-build\mingw\Tetris.exe

5. 输出位置

构建成功后，程序位于：

.vscode-build\mingw\Tetris.exe

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

• Tetris.utf8.rc
• Tetris.res.o

6. 推荐命令

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

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

如果构建后要立即运行：

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 配好。