删除无用文件 整理README等文件

VSCode运行说明.md

@@ -1,56 +1,72 @@
 # VS Code 运行说明
 
-本说明适用于 `Windows + VS Code + MinGW-w64` 环境。
+本项目推荐使用 `VS Code + MinGW-w64 + PowerShell` 构建和调试。
 
-## 1. 推荐环境
+## 1. 环境准备
 
-建议已安装：
+需要安装：
 
-- VS Code
+- Visual Studio Code
 - Microsoft C/C++ 扩展
-- PowerShell
 - MinGW-w64
+- PowerShell
+
+MinGW 中至少需要：
+
 - `g++.exe`
-- `gdb.exe`
 - `windres.exe`
+- `gdb.exe`，仅调试时需要
 
-## 2. 正确打开方式
+## 2. 打开项目
 
-请直接用 VS Code 打开项目根目录，也就是包含以下内容的目录：
+请在 VS Code 中打开项目根目录，也就是包含以下文件和目录的位置：
 
-- `build-mingw.ps1`
-- `.vscode/`
-- `src/`
-- `assets/`
+```text
+build-mingw.ps1
+src/
+assets/
+.vscode/
+README.md
+```
 
-不要只打开 `src/` 子目录，否则：
+不要只打开 `src/` 子目录，否则 VS Code 任务和调试配置无法正常工作。
 
-- 构建任务不可用
-- 调试配置不可用
-- 路径和资源引用可能失效
+## 3. 使用 VS Code 任务构建
 
-## 3. 构建方法
+按：
 
-### 方法一：快捷键
-
-按 `Ctrl + Shift + B`
+```text
+Ctrl + Shift + B
+```
 
 默认会执行项目中的 MinGW 构建任务。
 
-### 方法二：运行任务
-
-打开命令面板，执行：
+也可以打开命令面板，选择：
 
 ```text
 Tasks: Run Task
 ```
 
-然后选择：
+然后运行：
 
 - `build Tetris MinGW`
 - `run Tetris MinGW`
 
-## 4. 调试方法
+## 4. 使用命令行构建
+
+在 VS Code 终端中进入项目根目录，执行：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
+```
+
+构建后直接运行：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
+```
+
+## 5. 调试
 
 按 `F5`，选择：
 
@@ -58,91 +74,74 @@ Tasks: Run Task
 Debug Tetris MinGW
 ```
 
-该配置会先构建，再启动：
+调试配置会先构建项目，再启动：
 
 ```text
 .vscode-build\mingw\Tetris.exe
 ```
 
-## 5. 输出位置
+如果提示找不到 `gdb.exe`，说明 MinGW 的调试器没有安装或没有加入 `PATH`。
 
-构建成功后，程序位于：
+## 6. 构建输出
+
+最终程序：
 
 ```text
 .vscode-build\mingw\Tetris.exe
 ```
 
-中间产物位于同一目录下，例如：
+构建中间文件：
 
-- `Tetris.utf8.rc`
-- `Tetris.res.o`
-
-## 6. 推荐命令
-
-在 VS Code 终端中，也可以直接执行：
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
+```text
+.vscode-build\mingw\Tetris.utf8.rc
+.vscode-build\mingw\Tetris.res.o
 ```
 
-如果构建后要立即运行：
+这些中间文件不需要手动维护。
 
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
+## 7. 资源文件
+
+项目运行依赖：
+
+```text
+assets/icons/
+assets/images/
+assets/audio/
+assets/video/
 ```
 
-## 7. 常见问题
+如果只移动 `Tetris.exe` 而不带 `assets/`，会影响背景图、音乐和视频复活功能。
 
-### 1）提示找不到 `g++.exe`
+## 8. 常见问题
 
-说明 MinGW 没有正确安装，或者没有加入系统 `PATH`。
+### 找不到 `g++.exe`
 
 处理方式：
 
-- 把 MinGW 的 `bin` 目录加入 `PATH`
-- 或安装到 `C:\mingw64\bin\`
+- 将 MinGW 的 `bin` 目录加入系统 `PATH`
+- 或将 MinGW 安装到 `C:\mingw64\bin\`
 
-### 2）提示找不到 `windres.exe`
+### 找不到 `windres.exe`
 
-说明资源文件无法编译进程序。
+资源文件无法编译，图标和菜单资源可能缺失。请检查 MinGW 安装是否完整。
 
-结果通常是：
+### `Tetris.exe: Permission denied`
 
-- 主体代码可能还能编译
-- 但图标、菜单等资源会出问题
-
-### 3）提示 `Tetris.exe: Permission denied`
-
-通常是因为游戏程序还在运行，导致链接器无法覆盖旧的 `exe`。
+说明程序正在运行，构建时无法覆盖旧 exe。
 
 处理方式：
 
-- 先关闭正在运行的游戏窗口
-- 再重新执行构建
+1. 关闭游戏窗口
+2. 重新构建
 
-### 4）按 `F5` 无法调试
+### 鼠标点击、按钮或界面不是最新版
 
-一般是因为：
+通常是因为构建失败后仍在运行旧 exe。请确认构建命令成功完成。
 
-- 没安装 `gdb.exe`
-- 打开的不是项目根目录
-- VS Code 没有加载 `.vscode` 配置
+## 9. 推荐运行流程
 
-## 8. 资源说明
-
-项目运行依赖以下资源目录：
-
-- `assets/icons/`
-- `assets/images/`
-- `assets/audio/`
-- `assets/video/`
-
-如果只是拷贝 `exe` 而不带资源目录，部分功能会缺失，例如：
-
-- 背景图
-- 背景音乐
-- 复活视频
-
-## 9. 适用场景
-
-如果你主要在本机开发、调试和演示，VS Code 是本项目最推荐的运行方式。当前任务配置、构建脚本和资源处理流程都已经围绕 VS Code 配好。
+1. 打开项目根目录
+2. 关闭旧的游戏窗口
+3. 执行构建
+4. 运行 `.vscode-build\mingw\Tetris.exe`
+5. 如果要调试，按 `F5`