148 lines
2.5 KiB
Markdown
148 lines
2.5 KiB
Markdown
# 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`
|