讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

LinuxShell脚本执行失败_Shell错误排查

星宇酱_8680

星宇酱_8680

发布时间:2026-03-05 15:08:03

|

958人浏览过

|

来源于php中文网

原创

Shell脚本执行失败多因环境、权限、路径或解释器问题,需依次检查:可执行权限、shebang正确性(含换行符与BOM)、报错上下文、变量与路径引用规范及运行时上下文。

linuxshell脚本执行失败_shell错误排查

Shell脚本执行失败,多数情况不是语法“写错了”,而是环境、权限、路径或解释器细节没对上。排查时别急着重写,先盯住几个关键点。

检查脚本是否具备可执行权限

Linux不会因为文件后缀是 .sh 就自动执行它。必须有 x 权限:

  • 运行 ls -l script.sh 查看权限,若没有 x(如显示 -rw-r--r--),就无法直接 ./script.sh
  • 加上权限: chmod +x script.sh
  • 或者不依赖权限,改用解释器显式运行:bash script.sh 或 sh script.sh

确认第一行 shebang 是否正确且存在

脚本开头的 #!/bin/bash(或 #!/usr/bin/env bash)不是注释,它决定了用哪个解释器执行。常见问题:

Linux Security Scanner
Linux Security Scanner

Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...

下载
  • 路径写错,比如写成 #!/bin/sh 却用了 [[ ]] 或 source 的高级特性(/bin/sh 在很多系统里是 dash,不兼容 bash 扩展)
  • 换行符是 Windows 风格(CRLF),导致解释器路径末尾带 ^M,报错类似 /bin/bash^M: bad interpreter。用 dos2unix script.sh 或 sed -i 's/\r$//' script.sh 修复
  • 脚本保存为 UTF-8 with BOM,BOM 字节干扰 shebang 解析。用编辑器另存为 “UTF-8 no BOM” 或用 vim 输入 :set nobomb 后保存

定位报错行和实际错误类型

别只看最后一行报错,要结合输出上下文判断:

  • 命令未找到(command not found):检查命令拼写、是否在 $PATH 中,或加绝对路径(如用 /usr/bin/curl 而非 curl)
  • 语法错误(syntax error near unexpected token):常见于引号不配对、if 缺 fi、for 缺 done,或变量展开时没加双引号导致空格截断
  • 权限拒绝(Permission denied):可能是目标文件/目录不可写,或脚本尝试以普通用户身份操作需 root 的资源
  • 直接静默失败:加 set -u(报未定义变量)、set -e(出错立即退出)、set -x(打印每条执行命令)辅助调试,例如开头加:#!/bin/bash\nset -euo pipefail

验证变量、路径和当前工作目录

脚本行为高度依赖运行上下文:

  • 用 pwd 和 echo $0 确认当前路径和脚本自身位置;相对路径(如 ./data/file.txt)可能因执行位置不同而失效
  • 变量未引号包裹易出问题:比如 cp $SRC $DST,当 $SRC 含空格时会拆成多个参数。应写作 cp "$SRC" "$DST"
  • 环境变量在非登录 shell 中可能缺失(如 ~/.bashrc 里的自定义变量),脚本中不要默认它们已加载,必要时显式 source 或赋值

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

4510

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3773

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

3093

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

7650

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

7282

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4133

2023.07.20

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

3625

2023.07.20

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

3859

2023.07.25

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn