Claude Code 教程：从安装部署到 SpringBoot 项目实战

Claude Code 教程：从安装部署到 SpringBoot 项目实战 | 极客日志

要素	说明
精准需求	明确功能（如'用户登录接口'）、入参出参、业务规则（如'密码加密用 BCrypt'）
技术约束	指定框架版本（如 SpringBoot 2.7.x）、数据库（MySQL 8.0）、编码规范（阿里 Java 规范）
输出格式	要求'完整可运行代码 + 注释 + 测试用例'，避免碎片化代码

【需求】开发一个 SpringBoot 用户管理模块【技术约束】1. 框架：SpringBoot 2.7.10、MyBatis-Plus 3.5.3.1 2. 数据库：MySQL 8.0，表名 t_user，字段：id(BIGINT,主键)、username(VARCHAR)、password(VARCHAR)、create_time(DATETIME) 3. 功能：实现用户新增、查询（单条 + 列表）、修改、删除接口 4. 规范：遵循阿里 Java 开发手册，密码用 BCrypt 加密，接口返回统一 JSON 格式【输出要求】1. 完整代码：包含实体类、Mapper、Service、Controller、配置文件 2. 注释：关键方法添加详细注释 3. 测试：提供 Postman 测试用例（请求 URL+ 参数）

【目标】生成可直接运行的 SpringBoot 2.7.10 用户管理项目【技术栈】- 核心框架：SpringBoot 2.7.10、Spring MVC、MyBatis-Plus 3.5.3.1 - 数据库：MySQL 8.0，自动生成建表语句 - 工具：Lombok、Knife4j（接口文档）、BCrypt（密码加密）【功能】1. 基础功能：用户新增、根据 ID 查询、用户列表查询、修改用户信息、删除用户 2. 全局配置：统一返回结果、全局异常处理、跨域配置【输出要求】1. 按标准 Maven 项目结构输出所有代码文件（src/main/java + src/main/resources）2. 包含 pom.xml、application.yml、建表 SQL 3. 每个文件完整代码，标注文件路径（如 com.example.user.entity.User）4. 提供项目运行步骤和测试说明

<!-- pom.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.10</version>
        <relativePath/>
    </parent>
    <groupId>com.example</groupId>
    <artifactId>user-manage</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>user-manage</name>
    <description>SpringBoot 用户管理项目</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <!-- SpringBoot 核心 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- MyBatis-Plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.3.1</version>
        </dependency>
        <!-- MySQL 驱动 -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!-- Knife4j 接口文档 -->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.3</version>
        </dependency>
        <!-- 测试 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

// com.example.user.entity.User
package com.example.user.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;

/**
 * 用户实体类
 * @TableName t_user
 */
@Data
@TableName("t_user")
public class User {
    /**
     * 主键 ID
     */
    @TableId(type = IdType.AUTO)
    private Long id;
    /**
     * 用户名
     */
    private String username;
    /**
     * 密码（BCrypt 加密）
     */
    private String password;
    /**
     * 创建时间
     */
    private LocalDateTime createTime;
}

# application.yml
spring:
  # 数据库配置
  datasource:
    url: jdbc:mysql://localhost:3306/user_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  # MyBatis-Plus 配置
  mybatis-plus:
    mapper-locations: classpath:mapper/*.xml
    type-aliases-package: com.example.user.entity
    configuration:
      # 开启驼峰命名转换
      map-underscore-to-camel-case: true
      # 显示 SQL 日志
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  # 服务器配置
  server:
    port: 8080

CREATE TABLE `t_user` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键 ID',
  `username` varchar(50) NOT NULL COMMENT '用户名',
  `password` varchar(100) NOT NULL COMMENT '密码（BCrypt 加密）',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

【上下文】我已有的 SpringBoot 用户管理项目中，实体类 User 包含 id、username、password、create_time 字段，使用 MyBatis-Plus【需求】添加用户登录接口【要求】1. 接口路径：/user/login 2. 请求方式：POST 3. 请求参数：username（String）、password（String）4. 业务逻辑：- 校验用户名和密码是否为空 - 根据 username 查询用户，不存在则返回'用户不存在' - 用 BCrypt 匹配密码，错误则返回'密码错误' - 登录成功返回用户信息（隐藏 password）+ token（模拟生成）5. 输出：完整的 Controller 代码+Service 代码 + 统一返回结果类

// 统一返回结果类：com.example.user.common.Result
package com.example.user.common;
import lombok.Data;

/**
 * 统一返回结果
 */
@Data
public class Result<T> {
    /**
     * 状态码：200 成功，500 失败
     */
    private Integer code;
    /**
     * 提示信息
     */
    private String msg;
    /**
     * 数据
     */
    private T data;

    // 成功返回
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(200);
        result.setMsg("操作成功");
        result.setData(data);
        return result;
    }

    // 失败返回
    public static <T> Result<T> error(String msg) {
        Result<T> result = new Result<>();
        result.setCode(500);
        result.setMsg(msg);
        result.setData(null);
        return result;
    }
}

// Service 扩展：com.example.user.service.UserService
package com.example.user.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.user.common.Result;
import com.example.user.entity.User;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

public interface UserService extends IService<User> {
    /**
     * 用户登录
     * @param username 用户名
     * @param password 密码
     * @return 登录结果
     */
    Result<User> login(String username, String password);
}

// Service 实现类：com.example.user.service.impl.UserServiceImpl
package com.example.user.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.user.common.Result;
import com.example.user.entity.User;
import com.example.user.mapper.UserMapper;
import com.example.user.service.UserService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    private final BCryptPasswordEncoder passwordEncoder = new BCryptPasswordEncoder();

    @Override
    public Result<User> login(String username, String password) {
        // 1. 校验参数
        if (username == null || username.isEmpty() || password == null || password.isEmpty()) {
            return Result.error("用户名或密码不能为空");
        }
        // 2. 查询用户
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getUsername, username);
        User user = this.getOne(queryWrapper);
        if (user == null) {
            return Result.error("用户不存在");
        }
        // 3. 验证密码
        if (!passwordEncoder.matches(password, user.getPassword())) {
            return Result.error("密码错误");
        }
        // 4. 隐藏密码，模拟生成 token
        user.setPassword(null);
        // 实际项目中用 JWT 生成 token，此处简化
        return Result.success(user);
    }
}

// Controller 扩展：com.example.user.controller.UserController
package com.example.user.controller;
import com.example.user.common.Result;
import com.example.user.entity.User;
import com.example.user.service.UserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;

@RestController
@RequestMapping("/user")
@Api(tags = "用户管理接口")
public class UserController {
    @Resource
    private UserService userService;

    @ApiOperation("用户登录")
    @PostMapping("/login")
    public Result<User> login(@RequestParam String username, @RequestParam String password) {
        return userService.login(username, password);
    }
}

【问题】SpringBoot 用户登录接口返回 500，报错日志如下：java.lang.IllegalStateException: No bean of type 'org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder' available【需求】1. 分析报错原因 2. 提供修复方案和完整代码 3. 说明避免此类问题的注意事项

// 配置类：com.example.user.config.SecurityConfig
package com.example.user.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

/**
 * 安全配置类，注入 BCrypt 密码编码器
 */
@Configuration
public class SecurityConfig {
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

【上下文】我的 SpringBoot 项目中有用户列表查询接口，代码如下：@GetMapping("/list") public Result<List<User>> list() { List<User> list = userService.list(); return Result.success(list); }【问题】数据量 10 万时接口响应慢【需求】1. 添加分页功能 2. 优化查询性能（索引、分页插件）3. 输出完整优化后的代码

// 添加 MyBatis-Plus 分页插件配置
package com.example.user.config;
import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {
    /**
     * 分页插件
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

// 优化后的 Controller
@ApiOperation("用户列表分页查询")
@GetMapping("/list")
public Result<IPage<User>> list(
    @RequestParam(defaultValue = "1") Integer pageNum,
    @RequestParam(defaultValue = "10") Integer pageSize) {
    IPage<User> page = new Page<>(pageNum, pageSize);
    IPage<User> userPage = userService.page(page);
    return Result.success(userPage);
}

// 索引优化建议
/* 在 t_user 表的 username 字段添加索引，提升查询效率：
CREATE INDEX idx_t_user_username ON t_user(username);
*/

问题	解决方案
API Key 验证失败	检查 Key 是否过期，确认账号有 Claude Code 使用权限，网络环境是否合规
生成的代码无法运行	提示词中明确框架版本、依赖版本，要求 Claude 输出 pom.xml 完整依赖
本地项目导入后依赖报错	刷新 Maven 依赖（IDEA 中点击「Reload All Maven Projects」），检查仓库配置
生成的代码不符合编码规范	提示词中加入'遵循阿里 Java 开发手册'，指定代码风格（如驼峰命名、注释规范）

Claude Code 教程：从安装部署到 SpringBoot 项目实战

前言

一、Claude Code 安装部署（3 种主流方式）

1. 环境前置要求

2. 方式 1：网页版（零安装，快速尝鲜）

3. 方式 2：桌面客户端（跨平台，无浏览器限制）

4. 方式 3：IDEA 插件（推荐，本地开发无缝衔接）

步骤 1：安装插件

步骤 2：配置 API Key

二、Claude Code 提示词编写核心技巧（针对 Java/SpringBoot）

1. 提示词编写三要素

2. 经典提示词模板（直接复用）

3. 避坑指南

三、实战 1：用 Claude Code 生成完整 SpringBoot 项目并保存本地

步骤 1：编写精准提示词

步骤 2：获取 Claude Code 生成的代码

步骤 3：本地创建并导入项目

步骤 4：运行项目

四、实战 2：本地 SpringBoot 项目中使用 Claude Code（进阶示例）

场景 1：扩展功能 —— 添加用户登录接口

场景 2：Bug 排查 —— 修复接口返回异常

场景 3：代码优化 —— 提升查询接口性能

五、Claude Code 高级使用技巧

1. 结合本地代码上下文

2. 自定义提示词模板

3. 批量生成代码

六、常见问题与解决

七、总结

更多推荐文章

相关免费在线工具

Claude Code 教程：从安装部署到 SpringBoot 项目实战

前言

一、Claude Code 安装部署（3 种主流方式）

1. 环境前置要求

2. 方式 1：网页版（零安装，快速尝鲜）

3. 方式 2：桌面客户端（跨平台，无浏览器限制）

4. 方式 3：IDEA 插件（推荐，本地开发无缝衔接）

步骤 1：安装插件

步骤 2：配置 API Key

二、Claude Code 提示词编写核心技巧（针对 Java/SpringBoot）

1. 提示词编写三要素

2. 经典提示词模板（直接复用）

3. 避坑指南

三、实战 1：用 Claude Code 生成完整 SpringBoot 项目并保存本地

步骤 1：编写精准提示词

步骤 2：获取 Claude Code 生成的代码

步骤 3：本地创建并导入项目

步骤 4：运行项目

四、实战 2：本地 SpringBoot 项目中使用 Claude Code（进阶示例）

场景 1：扩展功能 —— 添加用户登录接口

场景 2：Bug 排查 —— 修复接口返回异常

场景 3：代码优化 —— 提升查询接口性能

五、Claude Code 高级使用技巧

1. 结合本地代码上下文

2. 自定义提示词模板

3. 批量生成代码

六、常见问题与解决

七、总结

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具