使用 fseek 定位文件内容：偏移量与起始位置说明

读取文件时，程序通常从当前位置继续读。如果需要跳到文件头、向前或向后移动若干字节，或者从文件尾部开始检查内容，可以使用 fseek()。它的关键不在于“跳到第几行”，而在于两个参数：偏移量和起始位置。

本文以 PHP 的 fseek() 为例，介绍它适合解决什么问题、偏移量如何计算、哪些流可以定位，以及越界和异常情况如何处理。示例可保存为 PHP 文件运行。

一、fseek 做什么

fseek() 移动一个流的文件指针。之后调用 fread()、fgets() 或其他读取函数时，操作从新的位置开始；调用 fwrite() 时，写入也从当前位置开始。

PHP 中的基本形式是：

<?php
fseek($stream, $offset, $whence = SEEK_SET);

• $stream：已打开的流，例如 fopen() 返回的文件句柄。
• $offset：以字节为单位的偏移量，类型为整数。
• $whence：偏移量的起算位置，默认为 SEEK_SET。

fseek() 成功时返回 0，失败时返回 -1。不要把它当作普通布尔值判断：在 PHP 中，0 在条件表达式里会被视为假，因此下面这种写法会把成功误判为失败：

<?php
if (fseek($stream, 0)) {
    // 这里并不能正确表达“定位失败”
}

应明确比较返回值是否为 0，或判断是否为 -1。后文会给出完整的错误处理示例。

二、偏移量从哪里开始计算

第三个参数 $whence 决定偏移量的起点。PHP 提供三个常用常量：

例如，若文件内容为 ABCDEFGHIJ，字节位置从 0 开始编号，那么：

• fseek($stream, 3, SEEK_SET) 将指针移到字节位置 3，即字符 D 所在的位置。
• 当前指针位于位置 3 时，fseek($stream, 2, SEEK_CUR) 会移到位置 5。
• fseek($stream, -3, SEEK_END) 会尝试移到文件末尾之前 3 个字节的位置。

注意，定位到某个字节并不等于已经读取了该字节。定位后调用 fread($stream, 1)，才会读取当前位置的一个字节，并让指针向后移动。

1. SEEK_SET：从文件头定位

SEEK_SET 是默认起算位置。偏移量为 0 表示文件开头；偏移量为 n 表示从开头数第 n 个字节的位置。

<?php
$stream = fopen(__DIR__ . '/sample.txt', 'rb');
if ($stream === false) {
    throw new RuntimeException('无法打开文件');
}

$result = fseek($stream, 5, SEEK_SET);
if ($result === 0) {
    $data = fread($stream, 10);
    var_dump($data);
} else {
    echo "定位失败\n";
}

fclose($stream);

rb 表示以只读二进制模式打开文件。在 PHP 中，文件模式是否加 b 对多数现代系统上的普通文件没有显著差别，但处理二进制数据时明确使用二进制模式更清晰，也有助于避免某些平台的文本模式转换行为。

2. SEEK_CUR：相对当前位置移动

偏移量可以是正数，也可以是负数。正数向文件尾方向移动，负数向文件头方向移动。移动的参照点是调用 fseek() 时的当前位置。

<?php
$stream = fopen(__DIR__ . '/sample.txt', 'rb');
if ($stream === false) {
    throw new RuntimeException('无法打开文件');
}

fseek($stream, 4, SEEK_SET);      // 移到位置 4
fseek($stream, 2, SEEK_CUR);      // 再向后移动 2 字节，移到位置 6

echo ftell($stream), "\n";        // 通常输出 6
fclose($stream);

若当前位置是 p，偏移量是 d，目标位置可理解为 p + d。如果结果落在文件开头之前，定位通常会失败；具体结果仍取决于底层流和运行环境，应检查返回值，而不要假定移动一定成功。

3. SEEK_END：从文件尾部定位

以 SEEK_END 为起点时，偏移量为 0 表示文件末尾；负数表示从末尾向前移动。比如 fseek($stream, -20, SEEK_END) 尝试移动到末尾之前 20 个字节。

可以先定位到末尾，再用 ftell() 取得当前位置，以获得当前流所报告的长度：

<?php
$stream = fopen(__DIR__ . '/sample.bin', 'rb');
if ($stream === false) {
    throw new RuntimeException('无法打开文件');
}

if (fseek($stream, 0, SEEK_END) !== 0) {
    throw new RuntimeException('无法定位到文件末尾');
}

$length = ftell($stream);
if ($length === false) {
    throw new RuntimeException('无法取得当前位置');
}

echo "长度（字节）：", $length, "\n";
fclose($stream);

对于普通、可定位的本地文件，这种方式常用于取得文件长度或读取尾部数据。不过，不要把它推广到所有流：某些包装器、管道或网络流不支持定位，或者其长度、末尾语义与普通文件不同。

三、可运行示例：定位并读取指定字节

下面的脚本创建一个临时文件，分别演示从开头定位、从当前位置移动、从末尾向前定位，并检查每次操作结果。将代码保存为 fseek_demo.php，使用 php fseek_demo.php 运行即可。

<?php
$path = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'fseek_demo.txt';
$content = "ABCDEFGHIJ";

if (file_put_contents($path, $content) === false) {
    throw new RuntimeException('无法写入示例文件');
}

$stream = fopen($path, 'rb');
if ($stream === false) {
    throw new RuntimeException('无法打开示例文件');
}

try {
    // 从文件开头跳过 3 个字节，读取接下来的 2 个字节。
    if (fseek($stream, 3, SEEK_SET) !== 0) {
        throw new RuntimeException('SEEK_SET 定位失败');
    }
    echo '从位置 3 读取：', fread($stream, 2), PHP_EOL; // DE

    // 此时指针在位置 5，再向后移动 2 个字节。
    if (fseek($stream, 2, SEEK_CUR) !== 0) {
        throw new RuntimeException('SEEK_CUR 定位失败');
    }
    echo '当前位置：', ftell($stream), PHP_EOL; // 7
    echo '当前位置读取：', fread($stream, 1), PHP_EOL; // H

    // 从文件末尾向前移动 3 个字节。
    if (fseek($stream, -3, SEEK_END) !== 0) {
        throw new RuntimeException('SEEK_END 定位失败');
    }
    echo '从末尾前 3 字节读取：', fread($stream, 3), PHP_EOL; // HIJ
} finally {
    fclose($stream);
    @unlink($path);
}

代码里的 ftell() 返回当前指针位置，单位同样是字节；它返回 false 时表示无法取得位置。读取函数也可能因为到达文件尾、读取错误或请求长度不足而返回比预期短的数据，所以生产代码不能只验证 fseek()，还应根据数据格式检查实际读取结果。

四、fseek 按字节工作，不按字符或行工作

最容易造成定位错误的原因，是把“字节偏移”误认为“字符位置”。对于 ASCII 文本，常见字符通常占一个字节，因此测试时容易忽略这个问题。但 UTF-8 中一个字符可能由多个字节组成。中文字符通常占多个字节，直接按字符数计算偏移，会落到字符编码的中间位置。

例如，一个 UTF-8 文件开头是“你好”。不能因为“好”是第二个字符，就假定它从字节位置 1 开始。应先明确文件的编码和字节布局，再计算字节偏移。若只是处理普通文本，通常使用 fgets()、逐行读取或其他文本解析方式更稳妥；如果需要按字符切分，应使用能够正确处理编码的函数，而不是依赖固定字节位置。

同理，fseek($stream, 100, SEEK_SET) 表示移动到字节位置 100，并不表示跳到第 100 行。只有在记录长度固定、编码与格式明确时，才能通过“记录编号 × 每条记录字节数”直接计算偏移。

五、适用场景

1. 固定长度记录

若文件格式规定每条记录恰好占 recordSize 个字节，那么第 n 条记录的起始位置通常可以按下式计算：

$offset = $headerSize + $recordIndex * $recordSize;

其中 $headerSize 是文件头的字节数，$recordIndex 通常从 0 开始。实际使用时应验证索引范围、整数运算结果和目标文件长度，并确认文件确实遵循该格式。若记录长度可变，这个公式就不成立，必须读取索引或扫描记录边界。

2. 二进制格式的字段读取

二进制文件往往把头部、索引区和数据区放在已知位置。程序可以先跳到相应偏移，再读取指定字节数并按格式解析。解析时要处理短读、字段长度、字节序和格式版本等问题；仅仅成功定位，并不代表数据符合预期格式。

3. 从文件尾部读取一段内容

日志检查、读取追加数据文件的尾部等场景，可以先尝试移动到末尾，再回退一定字节数。不过尾部起点未必是完整一行：若按文本行读取，应考虑边界处的半行、换行符格式和文件正在增长等情况。要可靠读取最后几行，通常需要从末尾分块向前扫描换行符，而不是假设“最后几行”对应一个固定字节数。

4. 随机访问已建立索引的文件

当文件另有索引，且索引记录了各条数据的位置时，可以直接定位到某个数据块，避免从头顺序读取。索引与数据文件必须保持一致；文件被替换、截断或重写后，旧偏移可能失效。更新流程应把索引与数据的生成、发布和校验作为一体处理。

六、关键边界与流限制

1. 并非所有流都支持定位

fseek() 不能保证适用于所有 PHP 流。普通本地文件通常可以定位，但网络连接、管道、某些流包装器或以只向前方式工作的资源可能不可定位，或只支持有限的定位操作。可以先用 stream_get_meta_data() 检查流元数据中的 seekable 标志：

<?php
$meta = stream_get_meta_data($stream);

if (empty($meta['seekable'])) {
    throw new RuntimeException('当前流不支持定位');
}

这个检查可以提前发现不适用的流，但不能代替对 fseek() 返回值的检查。流的具体能力还与包装器及其实现有关。

2. 负偏移量与文件开头

负偏移量并非一概错误：例如以 SEEK_END 为起点时，负数常用于从尾部回退。真正需要关注的是计算出的目标位置是否有效，以及该流是否支持这种操作。相对于当前位置回退时，如果目标位置早于文件开头，操作可能失败。不要只检查输入偏移量的正负，而应检查定位结果。

3. 超过文件末尾的位置

超出文件当前长度的位置不能简单理解为“文件中已经有这些数据”。对普通可定位文件，底层系统可能允许把位置移到末尾之后；此时后续读取通常不会凭空得到数据。若在该位置写入，文件系统和运行环境可能产生空洞文件等效果，但不应依赖这一点作为跨平台行为。若程序要求只在已有数据范围内读取，应先取得长度，并确保目标位置及读取范围没有超出文件长度。

也要注意，读取长度和偏移量是两个独立限制：定位成功后，fread() 仍可能因为到达 EOF 而返回较少字节。对于固定长度记录，应验证实际读取长度与格式要求一致，否则将不完整数据传给解析逻辑可能引发错误。

4. 整数范围和大文件

$offset 是 PHP 整数，整数范围受 PHP 构建和平台影响。对超大文件进行偏移计算时，应留意整数溢出以及计算结果是否仍为整数；不能假设每种环境都能表示任意大的文件位置。公式中的乘法也可能先于 fseek() 出错或溢出，因此要对输入范围进行约束，并在目标环境上测试大文件行为。

5. 文件变化会使偏移过时

偏移量只描述某个文件在某一时刻的字节位置。如果其他进程在读取期间截断、重写或插入数据，原本有效的偏移可能指向不同内容，甚至越出新的文件长度。并发访问需要根据应用设计使用锁、不可变文件、版本校验或原子替换等机制。文件锁也不是对所有参与方自动生效的强制保护，只有遵守同一协作规则的进程才会受到相应约束。

七、常见错误及修正方式

错误一：把成功返回的 0 当成失败

// 错误：成功时返回 0，而 0 在条件中为假。
if (!fseek($stream, 0, SEEK_SET)) {
    echo '定位失败';
}

// 正确：明确比较返回值。
if (fseek($stream, 0, SEEK_SET) === -1) {
    echo '定位失败';
}

使用严格比较可以清楚表达意图，也避免把成功状态和其他“假值”混在一起。

错误二：把偏移量当成字符数或行号

偏移量单位是字节，不是字符、行号或数组下标。对 UTF-8 文本，先确认编码和字节长度；对变长文本，不要用字符数直接跳转。若需要按行定位，可以在读取时建立行号到字节偏移的索引，或者顺序扫描到目标行。

错误三：忽略读取不足

成功定位只说明文件指针移动成功，不代表随后一定能读到请求的字节数。要读取固定长度字段，应检查 fread() 的结果长度：

<?php
$expected = 8;
$data = fread($stream, $expected);

if ($data === false || strlen($data) !== $expected) {
    throw new RuntimeException('数据不足或读取失败');
}

具体错误处理可以根据需求区分 EOF 和实际读取错误，但不要把短读默认为完整数据。

错误四：不检查 fopen 是否成功

fopen() 可能因路径错误、权限不足或文件不存在而返回 false。把它的结果直接传给 fseek()，既无法正确处理失败，也可能产生额外警告。应先确认句柄有效，并在适当位置关闭打开的资源。

错误五：误以为任意流都能定位

从本地文件切换到 URL、管道或自定义包装器后，定位能力可能变化。不要依赖“在我的测试文件上可用”推断所有输入都支持 fseek()；需要时检查 seekable 元数据，并处理定位失败的情况。

八、安全与稳健性

fseek() 只是移动文件指针，不会校验文件内容，也不会把不可信数据变成安全数据。尤其在处理用户提供的索引、记录编号或偏移量时，应把它们视为不可信输入：

• 限制偏移量和读取长度在业务允许的范围内，避免异常大值导致无意义的读写或计算开销。
• 检查整数运算是否溢出，并验证目标位置、记录长度及文件当前大小之间的关系。
• 从文件读取的字段仍需验证格式、长度和编码，不能因为偏移正确就信任其内容。
• 不要把偏移量校验当作路径权限控制。打开的文件路径仍应经过适当授权和限制。
• 不要把“定位成功”当作文件完整性或真实性证明；需要时使用格式校验、校验和或认证机制。

如果后续操作会写入文件，风险还包括覆盖现有数据、扩大文件或与其他进程的修改冲突。应按需求以合适模式打开文件，明确是否允许写入，并对写入范围、锁定策略和错误回滚作出设计。不能仅凭偏移量处于一个看似合理的数值，就认定写入是安全的。

九、一个稳健的定位与读取模式

下面的辅助函数展示了常见的检查顺序：确认流可定位、检查定位返回值、读取后验证实际长度。它不会替代针对文件格式的边界校验，但适合作为固定长度读取的基础。

<?php
function readAt($stream, int $offset, int $length): string
{
    if ($offset < 0 || $length < 0) {
        throw new InvalidArgumentException('偏移量和长度不能为负数');
    }

    $meta = stream_get_meta_data($stream);
    if (empty($meta['seekable'])) {
        throw new RuntimeException('当前流不支持定位');
    }

    if (fseek($stream, $offset, SEEK_SET) !== 0) {
        throw new RuntimeException('定位失败');
    }

    if ($length === 0) {
        return '';
    }

    $data = fread($stream, $length);
    if ($data === false || strlen($data) !== $length) {
        throw new RuntimeException('读取的数据长度不足');
    }

    return $data;
}

$stream = fopen(__DIR__ . '/sample.bin', 'rb');
if ($stream === false) {
    throw new RuntimeException('无法打开文件');
}

try {
    $bytes = readAt($stream, 16, 4);
    echo bin2hex($bytes), PHP_EOL;
} finally {
    fclose($stream);
}

示例假设调用方传入的偏移和长度是合法的，并要求恰好读取指定字节数。实际应用还应结合文件长度和业务格式限制参数。例如，若期望只读取已有文件范围，可以在计算 $offset + $length 前检查整数溢出，再验证读取范围不超过文件长度。对于可能被其他进程同时修改的文件，仅在定位前检查长度也不能完全消除竞态，应按并发模型采用锁或不可变数据等方案。

十、快速记忆

• fseek($stream, $offset, SEEK_SET)：偏移量从文件开头算。
• fseek($stream, $offset, SEEK_CUR)：偏移量从当前位置算。
• fseek($stream, $offset, SEEK_END)：偏移量从文件末尾算，负值常用于向前回退。
• 偏移量以字节计，不是字符数或行数。
• 成功返回 0，失败返回 -1；使用严格比较检查。
• 并非所有流都支持定位；定位成功也不保证后续读取足够长。
• 用户可控偏移量、文件长度、并发修改和整数范围都需要按场景验证。

掌握“从哪里算”和“按字节计算”这两点，就能正确理解大多数 fseek() 调用。真正可靠的文件处理还要继续检查流能力、返回值、读取长度和数据格式；这些检查比单纯把指针移到某个位置更重要。