极客教程

Appearance

共 794 字预计阅读约 3 分钟

C 语言 errno ​

更新时间：2026-08-26。本文是 languages/c/ 主题入门层第 70 篇。C 的函数没有异常机制，错误怎么传递？约定是：返回错误值 + 设置全局变量 errno 说明原因。文件打不开是"不存在"还是"没权限"？errno 告诉你。这一篇讲清 errno 的机制、常见取值和使用时最容易踩的三个坑。

本文要回答的问题 ​

  • errno 是什么？什么时候被设置？
  • 怎么把它转成可读的错误信息？
  • 使用 errno 有哪些注意事项？

一、errno 是什么 ​

errno 是一个线程局部的整型变量（现代 C 里是宏，展开成线程局部存储），标准库函数出错时设置它的值：

c
#include <stdio.h>
#include &lt;errno.h&gt;

FILE *fp = fopen("nofile.txt", "r");
if (fp == NULL) {
    printf("errno = %d\n", errno);    // 2（ENOENT，文件不存在）
}

关键规则：

  1. 只有函数失败时 errno 才有意义——成功时它可能残留上次的值；
  2. errno 不会被函数自动清零——新调用失败会覆盖，但成功调用不保证清；
  3. 判断顺序：先看返回值（成功/失败），再看 errno（为什么失败）。

二、perror 与 strerror ​

c
FILE *fp = fopen("nofile.txt", "r");
if (fp == NULL) {
    perror("fopen");              // fopen: No such file or directory
    printf("%s\n", strerror(errno));   // No such file or directory
    return 1;
}
  • perror(前缀)：打印 前缀 + ": " + 错误描述 到 stderr；
  • strerror(errno)：返回错误描述的字符串，方便拼进自定义日志。

三、常见 errno 值 ​

errno数值（Linux）含义
EPERM1操作不被允许
ENOENT2文件或目录不存在
EACCES13权限不足
ENOSPC28磁盘已满
EINVAL22参数无效
ERANGE34结果超出范围（如 strtol 溢出）
ETIMEDOUT110连接超时

永远用符号名（ENOENT）而不是数字——数值在不同平台可能不同，符号名是标准化的。

四、使用 errno 的注意事项 ​

1. 调用前清零（需要区分"上一次错误"时）：

c
errno = 0;
long v = strtol("abc", &end, 10);
if (errno == ERANGE) { ... }        // 只有清零后才可信

2. 失败函数的返回值检查优先：

c
int *p = malloc(1024);
if (p == NULL) {
    if (errno == ENOMEM) { /* 内存不足 */ }
}

3. 别把 errno 当布尔：if (errno) 不可靠——残留值会误报。

五、错误处理模式 ​

c
int read_config(const char *path) {
    FILE *fp = fopen(path, "r");
    if (fp == NULL) {
        fprintf(stderr, "open %s failed: %s\n",
                path, strerror(errno));     // 具体原因
        return -1;
    }
    /* ... */
    fclose(fp);
    return 0;
}

模式总结：

  1. 返回值判断成败（NULL、-1、EOF）；
  2. errno 说明细节（strerror 转文本）；
  3. 失败路径：报告 + 返回错误码，别继续用坏状态。

六、常见坑对照 ​

坑现象对策
成功时读 errno读到残留值只看失败时
调用前不清零误判溢出关键调用前 errno=0
用数字而非常量名跨平台错用 ENOENT 等
只查 errno 不看返回值逻辑错乱返回值优先
忘记 #include <errno.h>编译错头文件带上

七、与本站主线衔接 ​

一句话总结 ​

errno 是库函数失败时的"原因说明"（线程局部整型），用 perror/strerror 转成可读文本；铁律是——先看返回值判断成败、再看 errno 问原因、需要时调用前清零、永远用符号名——返回值告诉你"错了"，errno 告诉你"为什么错"。