从一份源码，
到第一次成功运行。
先准备环境，再连接数据，最后启动项目。
按你的技术栈，一步一步来。
先确认这四件事
不要只看目录后缀。以实际源码、依赖文件和配套文档判断项目类型。
已准备 0 / 4 项
如何检查本机环境？
在终端逐行执行。命令无法识别时，检查安装和 PATH；Maven 输出的 Java 版本也应与项目要求一致。
java -version
mvn -v
node -v
npm -v没有 Vue 前端的项目通常不需要后两项。IDE 使用的 JDK 还需在项目设置中单独核对。
后端先跑通，前端再连接
SSM + Vue 依次阅读 SSM 和 Vue；Spring Boot + Vue 依次阅读 Spring Boot 和 Vue。下面的项目名和端口仅作示例。
SSM 项目：交给 Tomcat 运行
- 导入 Maven 工程
在 IDE 中打开包含 pom.xml 的目录，加载 Maven 依赖，配置项目 JDK。先查看 packaging 是否为 war，以及 Spring、Servlet 等依赖版本。
- 创建数据库并导入 SQL
使用 DBeaver 等数据库工具连接本地 MySQL。检查 SQL 是否包含建库或删表语句，确认目标是测试库后再导入，核对表和初始数据是否完整。
- 修改数据库与路径配置
常见位置是 src/main/resources/config.properties、jdbc.properties 或 Spring XML。修改地址、端口、库名、用户名和密码。JSP 项目还可能在 baseUrl.jsp 中写有访问地址。
- 打包并部署
在 pom.xml 所在目录执行下方命令。成功后在 target 中找到实际 WAR 文件，放入已配置好的 Tomcat 的 webapps 目录，再启动 Tomcat；也可使用 IDE 支持的 Tomcat 部署功能。
mvn package - 验证页面和日志
例如 project.war 通常对应 http://localhost:8080/project/，但登录入口需按项目说明访问。确认 Tomcat 日志没有部署异常，再测试登录与列表查询。若前端是 Vue，继续阅读 Vue 路线。
Spring Boot：从启动类开始
- 导入工程，核对版本
打开 pom.xml，查看 Spring Boot 版本及 Java 要求。不同版本的最低 JDK 不同，不能把所有项目统一按某个 JDK 安装。
- 导入数据库，修改当前环境配置
检查 application.yml 或 application.properties，以及 application-dev 等分环境文件。核对实际生效的 profile，修改数据源、服务端口与上下文路径。保留项目原有配置结构。
- 运行启动类
找到包含 @SpringBootApplication 和 main 方法的启动类，在 IDE 中运行。若启动失败，先看日志中最早的有效异常及 Caused by，检查数据库、依赖与端口。
- 需要时打包运行
配置了 Spring Boot 打包插件的 Maven 工程，可先执行 mvn package，再运行生成的可执行 JAR。下方 app.jar 是占位名称，需替换成实际文件名；普通 JAR 或 WAR 不适用同样的启动方式。
mvn package java -jar target/app.jar - 确认接口或页面可访问
使用日志显示的端口和配置中的上下文路径，访问项目文档指定的入口。接口服务的根地址返回 404，不一定表示启动失败。带 Vue 的项目继续完成前端配置。
Vue：安装依赖，连接后端
- 进入真正的前端目录
找到 package.json 所在目录，先看 scripts 和 engines。有些项目的前端在 admin 或 front 中，也可能位于 src/main/webapp 下。
- 准备兼容的 Node.js 并安装依赖
按项目说明和锁文件选择版本与包管理器。使用 npm 的项目通常执行下方命令；旧 node-sass 项目尤其要核对 Node 兼容性，不要一开始就删除锁文件或强制升级全部依赖。
npm install - 修改 API 地址和开发代理
常见位置包括 .env 文件、src/utils/base.js 和 vue.config.js。接口地址必须包含正确的后端端口与上下文路径。开发代理只作用于开发服务器，构建上线时需另行配置生产接口或反向代理。
- 运行已定义的开发命令
先执行 npm run 查看可用脚本。Vue CLI 项目常用 npm run serve，其他工程可能是 npm run dev；以 scripts 为准，不能仅凭 Vue 版本判断。
npm run npm run serve - 联调与构建
打开终端显示的前端地址，测试登录和数据列表。如需静态构建，执行项目定义的 build 脚本，通常生成 dist。构建产物需通过 Web 服务访问，不要直接双击 index.html；服务器部署还需核对接口代理和路由回退。
npm run build
常见问题，逐项排查
数据库连接失败或 Access denied+
确认 MySQL 服务已启动，端口、库名和账号密码正确，账号具有目标库权限。先用数据库工具验证同一组连接参数，再检查实际生效的项目配置。
启动出现端口占用+
检查是否重复启动了同一个服务，停止自己先前启动的实例或更换服务端口。更换端口后同步修改 Vue 接口地址和代理配置。
页面 404 或前端一直没有数据+
先确认后端启动日志，再检查项目路径和登录入口。在浏览器开发者工具的 Network 中查看失败请求，区分地址错误、未登录、服务异常和跨域问题。
JDK 或 Tomcat 不兼容+
遇到 UnsupportedClassVersionError 时核对编译与运行 JDK；遇到 javax.servlet 或 jakarta.servlet 类加载错误时核对框架、Servlet 依赖和容器版本。不要只修改版本号后忽略依赖兼容性。
npm install 报错或找不到 serve 命令+
确认当前目录存在 package.json，检查 Node 和 npm 版本、网络及报错中的具体依赖。没有 serve 脚本时执行 npm run 查看现有命令；node-sass 失败时按项目要求核对兼容版本。
显示跨域错误，应该怎么处理？+
先核对前端实际请求地址与开发代理是否匹配。开发环境优先按项目已有代理方案联调；生产环境结合反向代理或后端明确的跨域配置处理，不要通过关闭浏览器安全检查解决。
本地能运行，是不是就可以直接上线？+
本页主要帮助本地学习与联调。服务器上线还需要处理域名、HTTPS、生产配置、数据库权限、日志及进程管理，开发服务器与本地测试配置不应直接当作正式部署方案。
