byte是Java最小整数类型，占1字节、取值-128~127，有符号、自动提升为int，适用于IO和协议解析，但需防溢出和隐式转换错误。
Java 中的 byte 是最小的整数基本数据类型，占 1 个字节（8 位），取值范围是 -128 到 127。它适合处理小范围整数、网络通信、文件读写和底层数据操作，但容易因溢出或隐式类型转换引发问题。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
字节型的核心特点
• 占用内存最小：仅 1 字节，比 int（4 字节）、short（2 字节）更节省空间，适合大量数据存储场景
• 有符号类型：最高位为符号位，所以不是 0~255，而是 -128~127
• 自动类型提升：参与运算时会自动提升为 int，比如 byte a = 1; byte b = 2; byte c = a + b; 会编译报错，因为 a + b 结果是 int，需显式强转：byte c = (byte)(a + b);
• 不支持直接赋值超限值：如 byte x = 130; 编译失败；但 byte x = (byte)130; 可行（结果为 -126，因二进制截断）
常见使用场景与写法
• 文件/流操作中读取原始字节：
FileInputStream fis = new FileInputStream("data.bin");
int data;
while ((data = fis.read()) != -1) {
byte b = (byte) data; // read() 返回 int，需转为 byte
// 处理单个字节
}
• 定义常量或状态码（值小且固定）：
public static final byte STATUS_OK = 0;
public static final byte STATUS_ERROR = 1;
public static final byte MODE_READ = (byte)0x01;
• 构建字节数组用于网络协议或加密：
byte[] header = {0x48, 0x54, 0x54, 0x50}; // "HTTP" ASCII 码
避坑要点与注意事项
• 不要用 byte 存储年龄、ID 等可能超限的业务数值（比如年龄 200 岁就溢出）
• 和 String 互转要小心编码：new String(bytes, StandardCharsets.UTF_8) 比 new String(bytes) 更安全
• 数组初始化别漏了类型声明：byte[] buf = new byte[1024];，不能写成 new byte[1024] 后再赋给非 byte[] 变量
• 与包装类 Byte 交互时注意空指针（尤其在集合中）：List
基本上就这些。byte 看似简单，但在 IO、协议解析、性能敏感场景里很关键，用对了省空间，用错了容易静默出错。
