os.file.seek需严格使用io.seekstart/current/end常量，校验返回err，避免负偏移+seekend；断点续传优先用线程安全的readat/writeat，并配合f.sync()、元数据文件校验及inode一致性检查。
Go 中 os.File.Seek 怎么用才不会跳错位置
断点续传依赖精准的文件指针控制，os.File.Seek 是唯一入口，但它不校验偏移合法性，也不会自动处理读写模式差异。常见错误是传入负数偏移却没确认文件是否支持反向寻址，或在只读文件上调用写模式偏移（io.SeekStart 没问题，但 io.SeekCurrent 或 io.SeekEnd 在某些挂载文件系统上会失败）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
os.File.Seek第二个参数必须是io.SeekStart、io.SeekCurrent或io.SeekEnd—— 别手误写成数字 0/1/2，Go 不做隐式转换 - 调用前检查返回值：如果返回
offset, err := f.Seek(pos, io.SeekStart)，且err != nil，说明目标位置超出当前文件长度（比如文件只有 100 字节，却 seek(200, io.SeekStart)），此时不能继续读写 - 若需从末尾倒推（如续传时已知剩余字节数），用
f.Seek(0, io.SeekEnd)先获取总长度，再算真实起始偏移，别直接f.Seek(-n, io.SeekEnd)—— 多数文件系统不支持负偏移 +SeekEnd
为什么 os.File.ReadAt 和 os.File.WriteAt 更适合断点续传
Seek + Read 组合在并发场景下容易出错：多个 goroutine 共享同一个 *os.File，Seek 后还没 Read，另一个就改了指针，结果读到错位数据。而 ReadAt 和 WriteAt 是无状态的，不依赖当前文件偏移，天然线程安全。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 断点续传下载时，优先用
f.ReadAt(buf, offset)替代f.Seek(offset, io.SeekStart); f.Read(buf) -
ReadAt返回实际读取字节数，可能小于len(buf)（比如到达 EOF），必须检查，不能假设填满 - 写入时同理：
f.WriteAt(buf, offset)不会移动内部指针，也不影响后续其他 goroutine 的WriteAt调用 - 注意：Windows 上对普通文件使用
WriteAt可能触发权限错误，需确保文件以os.O_RDWR打开，且未被其他进程独占锁定
断点续传中如何安全判断“已下载部分”是否完整
仅靠文件长度判断不可靠 —— 网络中断可能导致最后几个字节写了一半，或者磁盘缓存未刷盘。更稳妥的方式是结合服务端提供的 Content-Range 响应头和本地已写入的校验值（如分块 hash 或整个文件的 MD5）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每次写入后调用
f.Sync()，强制刷盘；否则断电或崩溃会导致WriteAt看似成功，实际数据丢失 - 不要依赖
f.Stat().Size()作为“已续传长度”，它反映的是当前文件大小，但最后块可能损坏；应维护一个独立的元数据文件（如file.part.json），记录已验证通过的偏移量和对应 hash - 恢复续传前，先读取元数据文件，再用
f.ReadAt读取最后一块，重新计算 hash 并比对 —— 匹配才认为该块完整
HTTP 断点续传请求头怎么配才让服务端真正返回 206
客户端发了 Range: bytes=1000-，但服务端仍返回 200，说明它没开启范围请求支持，或路径被代理/CDN 缓存拦截。Go 标准库的 http.Client 不会自动加 Accept-Ranges: bytes，那是响应头，不是请求头。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须显式设置请求头：
req.Header.Set("Range", "bytes=1000-")，且不能同时带If-Range（除非你有 ETag） - 收到响应后立刻检查
resp.StatusCode == http.StatusPartialContent（即 206），如果不是，说明服务端不支持或拒绝了范围请求，此时应清空文件重下，而不是强行续传 - 注意响应头中的
Content-Range，例如bytes 1000-1999/5000，其中5000是总大小，必须与预期一致；若为*/5000，表示服务端没返回当前段长度，不可信
最易被忽略的一点：os.File 的 Seek 和 ReadAt 都不关心文件是否被其他进程截断或覆盖。断点续传过程中，如果用户手动删了文件又新建同名文件，你的偏移量会直接写进新文件的错误位置 —— 所以得用 os.SameFile 或 inode 检查文件是否还是原来的那个。
