已初始化若依后端项目需满足：根目录含pom.xml和RuoYiApplication.java；Maven依赖解析成功；JDK 17+及Java/Spring Boot扩展已安装；运行RuoYiApplication.java后终端显示“Started RuoYiApplication”并监听8080端口。

确认是否已初始化若依后端项目

若依（RuoYi）是基于 Spring Boot 的 Java 后台管理系统，它本身不是 VS Code 原生支持的项目类型，必须先确保你拿到的是完整可运行的后端源码（通常是 ruoyi-admin 模块），而不是只下载了前端或文档。常见错误是直接打开 ruoyi-vue（前后端分离版）的根目录，但没启动后端服务，导致前端报 500 或跨域失败。

• 检查项目根目录下是否有 pom.xml 和 src/main/java/com/ruoyi/RuoYiApplication.java
• 确认 ruoyi-admin 是 Maven 模块，且依赖已正确解析（VS Code 中 Java 扩展会显示“Maven Projects”侧边栏）
• 若用的是若依微服务版（RuoYi-Cloud），需额外启动 Nacos、Sentinel 等组件，不能只跑 RuoYiApplication

VS Code 中配置并运行 Spring Boot 主类

VS Code 本身不内置 Java 运行环境，必须装好 JDK 17+、Extension Pack for Java（含 Debugger for Java）、Spring Boot Extension Pack。否则点击“运行”会提示 “No Java runtime present” 或找不到 main 方法。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 右键 RuoYiApplication.java → “Run Java”（不是“Run Code”）
• 首次运行可能弹出 launch.json 配置建议，选“Java”模板即可，无需手动改 mainClass，插件能自动识别
• 观察终端输出：成功启动时会有 Started RuoYiApplication in X.XXX seconds，并监听 http://localhost:8080
• 若卡在 Tomcat started on port(s): 8080 (http) 后无后续，说明启动完成；若卡在数据库连接处，检查 application.yml 中的 spring.datasource.url 是否指向本地 MySQL（默认 localhost:3306）

前端联调前必须解决跨域和登录路径问题

若依前后端分离版（RuoYi-Vue）默认请求 /prod-api/ 前缀，而后端 Spring Boot 默认不带该前缀。直接 npm run dev 会 404 所有接口，这不是 VS Code 的问题，是配置没对齐。

• 后端需在 application.yml 中开启网关或配置路径匹配：

  spring:
    mvc:
      pathmatch:
        matching-strategy: ant_path_matcher

  （Spring Boot 2.6+ 必加）
• 前端 .env.development 中的 VUE_APP_BASE_API 应为 'http://localhost:8080'，而非 '/prod-api'（后者是生产代理用）
• 若仍报跨域，检查后端 @Configuration 类中是否启用了 @EnableWebMvc —— 若启用了，需手动配 CorsConfiguration，否则全局 @CrossOrigin 失效

调试时别忽略日志和端口冲突

VS Code 的 Java 调试器很稳，但若依启动慢、依赖多，容易掩盖真实问题。比如控制台没报错，但页面一直转圈，大概率是数据库连不上或 Redis 未启动，而不是代码逻辑问题。

• 启动前先执行 mysql -u root -p 和 redis-cli ping，确认服务在运行
• 若提示 Address already in use: bind，检查是否已有其他 Java 进程占了 8080 —— 可临时改 server.port=8081 测试
• 调试断点打在 LoginController.login() 里，但请求根本没进来？优先看浏览器 Network 面板的 Request URL 和 Status，再查后端日志里有没有 Resolved [AuthenticationException] 类错误

启动若依不是点一下就完的事，它依赖一整套外部中间件和配置对齐。VS Code 只是载体，真正卡住的地方永远在 application.yml、MySQL 用户权限、Redis 密码、还有那个被很多人忽略的 ant_path_matcher 配置。