没吃饱的笨蛋

外观

crontab 常用用法速查

约 892 字大约 3 分钟

2026-05-14

crontab 用来配置周期性任务，例如定时备份、定时清理日志、定时执行脚本。它语法简单，但很容易因为环境变量、路径和输出日志处理不当而踩坑。

阅读导览
crontab 常用用法速查

`crontab` 用来配置周期性任务，例如定时备份、定时清理日志、定时执行脚本。它语法简单，但很容易因为环境变量、路径和输出日志处理不当而踩坑。

  • 理解五段时间表达式
  • 编辑和查看定时任务
  • 常见时间写法
  • 日志和环境变量注意事项
命令速查
crontab 高频命令速查
终端必备
crontab -e
编辑任务

编辑当前用户的定时任务。

crontab -l
查看任务

列出当前用户的 crontab。

0 2 * * * /path/backup.sh
每天凌晨执行

每天 02:00 执行脚本。

*/5 * * * * /path/check.sh
每 5 分钟执行

高频巡检任务常见写法。

基本格式

分 时 日 月 周 命令

示例：

0 2 * * * /usr/local/bin/backup.sh

表示每天凌晨 2 点执行备份脚本。

常见时间写法

写法含义
* * * * *每分钟
*/5 * * * *每 5 分钟
0 * * * *每小时整点
0 2 * * *每天 02:00
0 2 * * 1每周一 02:00
0 2 1 * *每月 1 日 02:00

管理任务

crontab -e  # 编辑当前用户任务
crontab -l  # 查看当前用户任务
crontab -r  # 删除当前用户所有任务，谨慎使用

系统级任务通常在 /etc/crontab、/etc/cron.d/ 或 systemd timer 中管理。

处理输出日志

0 2 * * * /path/backup.sh >> /var/log/backup.log 2>&1

如果不处理输出，任务产生的标准输出和错误输出可能通过邮件发送，或者直接丢失，不利于排查。

环境变量和路径

crontab 的执行环境比交互式 shell 简洁，很多命令路径和环境变量都不存在。建议：

SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

0 2 * * * cd /opt/app && /usr/bin/bash scripts/backup.sh >> /var/log/backup.log 2>&1

先手动运行

把命令放进 crontab 前，先在终端手动运行一次，并尽量使用绝对路径。

先判断任务是否适合 crontab

crontab 适合简单、固定周期、失败后不需要复杂编排的任务。如果任务依赖关系很多、需要重试、需要观察状态，可能更适合 systemd timer、CI 调度器或专门的任务队列。

任务类型是否适合 crontab说明
每天备份一个目录适合命令固定，周期清楚
每 5 分钟健康检查适合注意日志不要无限增长
多步骤数据流水线不一定失败处理和依赖关系会复杂
长时间常驻服务不适合应交给 systemd 管理

不执行时怎么排查

  1. crontab -l 确认任务真的写进去了。
  2. 把命令复制出来，在终端手动运行一次。
  3. 改成绝对路径，例如 /usr/bin/python3 /opt/app/job.py。
  4. 给脚本加执行权限：chmod +x script.sh。
  5. 把输出重定向到日志：>> /tmp/job.log 2>&1。

多数 crontab 问题不是时间表达式错，而是执行环境和你手动登录的 shell 不一样。

重点总结
要点回收
  • crontab 适合简单固定周期任务，不适合长期常驻服务。
  • 定时任务失败时优先检查绝对路径、环境变量、执行权限和日志输出。
  • 写入 crontab 前先手动运行命令，减少隐藏环境差异。

版权归属：Shuo Liu

许可证：署名-非商业性 4.0 国际 (CC-BY-NC-4.0)