initial

docs/guides/BUILD_INSTRUCTIONS.md

@@ -0,0 +1,69 @@
+# 编译说明
+
+## 重要提示
+
+在重新编译之前，请**先关闭正在运行的 `agv_qt_gui.exe` 程序**！
+
+检测到程序正在运行（进程ID: 2996），需要先关闭才能重新编译。
+
+## 关闭程序的方法
+
+### 方法1: 通过任务管理器
+1. 按 `Ctrl + Shift + Esc` 打开任务管理器
+2. 找到 `agv_qt_gui.exe` 进程
+3. 右键点击，选择"结束任务"
+
+### 方法2: 通过命令行
+在 **Windows命令提示符**（不是Git Bash）中运行：
+```cmd
+taskkill /F /PID 2996
+```
+
+或者查找并关闭所有 agv_qt_gui 进程：
+```cmd
+taskkill /F /IM agv_qt_gui.exe
+```
+
+## 编译步骤
+
+关闭程序后，执行以下命令重新编译：
+
+```bash
+cd build
+cmake --build . --config Release
+```
+
+或者如果需要Debug版本：
+```bash
+cmake --build . --config Debug
+```
+
+## 编译成功的标志
+
+如果编译成功，应该看到：
+```
+agv_qt_gui.vcxproj -> C:\work\AGV\AGV运动规划\agv_path_tracking\build\Release\agv_qt_gui.exe
+```
+
+## 运行修复后的程序
+
+编译成功后，运行：
+```bash
+# Release版本
+./build/Release/agv_qt_gui.exe
+
+# 或 Debug版本
+./build/Debug/agv_qt_gui.exe
+```
+
+然后测试"Load from CSV"功能，特别是：
+1. 尝试加载包含中文路径的CSV文件
+2. 尝试加载各种格式的CSV文件
+
+## 已修复的问题
+
+✓ Windows路径编码问题（主要原因）
+✓ 单点路径处理
+✓ 异常处理改进
+
+所有修改已应用到源代码，只需重新编译即可生效。