Go copy 返回值为什么可能小于源切片长度：重叠切片与容量边界

Go 里调用 copy 后，返回值有时会比源切片长度小，这通常不是复制失败，而是目标切片没有足够的长度。判断这类问题要看 len(dst)、len(src) 和返回的 n，不能把 cap(dst) 当成当前可写空间。

先用 len(dst)、len(src) 和 n 对上结果

copy 的返回值 n 表示实际复制了多少个元素。它不会按照目标切片的容量自动扩展长度，最常见的判断就是：

dst := make([]byte, 3)
src := []byte("golang")
n := copy(dst, src)
fmt.Printf("dst=%q n=%d len(dst)=%d len(src)=%d\n", dst, n, len(dst), len(src))
// dst="gol" n=3 len(dst)=3 len(src)=6

这里 n 是 3，因为 len(dst) 为 3，而 len(src) 为 6。copy 只会写入目标切片当前长度覆盖的元素，结果不会因为底层数组还有空间就自动变成 6 个字节。

如果业务要求完整复制，应该先把目标切片调整到需要的长度，并把长度检查写在调用点：

src := []byte("golang")
dst := make([]byte, len(src))
n := copy(dst, src)
if n != len(src) {
    return fmt.Errorf("copy incomplete: n=%d want=%d", n, len(src))
}

这个检查表达的是业务约束，而不是 copy 的额外保证。对固定大小缓冲区来说，n 可能正是预期行为；对完整快照来说，它才应该被当成错误。

容量够不等于目标长度够

很多“为什么没复制进去”的问题来自对长度和容量的混淆：

dst := make([]byte, 0, 8)
src := []byte("go")
n := copy(dst, src)
fmt.Printf("n=%d len(dst)=%d cap(dst)=%d\n", n, len(dst), cap(dst))
// n=0 len(dst)=0 cap(dst)=8

虽然 cap(dst) 是 8，但 len(dst) 仍然是 0，所以这次 copy 的目标范围为空，n 就是 0。若想把数据放进这块预留空间，可以先扩展长度：

dst := make([]byte, 0, 8)
dst = dst[:len(src)]
n := copy(dst, src)
fmt.Printf("%q n=%d\n", dst, n)
// "go" n=2

切片表达式只改变切片视图的长度，不会初始化新的业务数据；因此扩展前要确认目标容量足够。另一种更适合“追加”语义的写法是 dst = append(dst, src...)，它会根据需要扩容并返回新的切片。

重叠切片复制时，先确定源和目标区间

源切片和目标切片可以共享底层数组。下面的代码把后两个元素向前移动一个位置：

buf := []byte{'a', 'b', 'c', 'd'}
n := copy(buf[1:], buf[:3])
fmt.Printf("%q n=%d\n", buf, n)
// "aabc" n=3

目标是 buf[1:]，源是 buf[:3]，两者发生重叠，但 copy 会正确处理这种情况，最终前三个源元素被移动到目标区间。这里的 n 仍取两个切片长度的较小值，并不因为共享数组而减少。

排查重叠复制时，可以把问题拆成三个事实：先标出源区间，再标出目标区间，最后核对 n 是否覆盖期望长度。不要仅凭最终数组猜测执行顺序，也不要把这类移动误写成手工循环后再依赖未处理的重叠方向。

把 copy 返回值变成可核对的边界

在解析报文、移动窗口或复用缓冲区时，可以把复制操作包成一个带边界检查的小函数：

func copyExact(dst, src []byte) error {
    if len(dst) 

这个函数只适合“必须完整复制”的调用点；滑动窗口、分块写入和固定大小缓冲区往往允许 n 小于源长度，应由调用方明确剩余空间与下一块数据的位置。边界的关键不是统一追求 n == len(src)，而是让每次复制的目标长度和业务意图一致。

常见问题：copy 的返回值为什么不是源长度

copy 会自动按照 cap(dst) 扩大目标吗？

不会。copy 只使用目标切片当前的 len；需要更长目标时，先调整长度或改用 append。

源和目标重叠会导致 copy 结果不可靠吗？

不会。切片复制允许重叠，标准语义会得到正确的移动结果；仍要先核对两个区间和预期覆盖范围。

什么时候应该检查 n？

当调用点要求完整复制、完整快照或完整报文时检查 n。如果是固定缓冲区或分块处理，n 小于源长度可能只是本轮可用空间的正常边界。

收尾：先看长度，再谈复制结果

遇到 copy 返回值偏小，优先同时打印 len(dst)、len(src)、cap(dst) 和 n，再确认源目标是否重叠。长度决定本次复制范围，容量只说明底层数组还有多少可扩展空间；把这两个概念分开，绝大多数切片复制边界都能很快定位。