项目第一次运行失败，先整理哪些信息

从原始运行说明开始

第一次先按项目附带的运行说明安装和启动，保留原始配置示例。不要同时升级依赖、替换数据库和改业务功能，否则很难判断问题来自哪个变化。

确认当前目录、运行时版本、虚拟环境或包管理器以及执行的命令。把这些信息记录到自己的准备清单里。

分清停在哪一步

先判断哪个进程没有正常运行，再围绕该步骤检查。日志中的口令、密钥和个人资料需要在分享前遮去。

• 依赖安装：确认版本要求、安装日志和网络是否可用，记录第一条关键错误。
• 后端启动：检查当前环境、配置是否加载、端口是否占用，以及完整异常信息。
• 数据库连接：确认地址、端口、账号权限、库名，以及初始化步骤是否完成。
• 前端请求：查看后端是否已启动、接口地址和代理设置，以及浏览器控制台与网络请求结果。

给出能复现的反馈

一份有用的反馈包括：操作系统与版本、项目版本、启动命令、发生问题的步骤、期望结果、实际结果，以及关键日志。截图可以补充说明，但可复制的错误文本便于进一步查找。

如果只有某个功能失败，记录测试角色和输入示例。避免提供真实客户数据，可以用虚拟数据复现同一流程。

恢复运行后，再做改动

原项目跑通后，先记录主要流程的结果。每次只做一个可验证的修改，并保留改动前的文件或版本记录。这样出现问题时能回到已确认可运行的状态。

准备清单是整理条件的工具，不会自动检测或保证项目运行。需要部署协助时，请在联系页说明本地或服务器环境、当前进展和希望协助的范围。