所有托管服务节省 15%

测试技能，享折扣

使用代码： Skills 开始使用
China
01.11.2024 更新于：30.06.2026
Linux
12 +1 4 min

理解Shebangs：在Linux终端中执行Bash和Python脚本

如果你曾在 Linux 上编写过 shell 或 Python 脚本，并想知道系统如何知道使用哪个解释器 — 答案在于文件顶部的一个小但强大的两字符序列：shebang (#!)。

无论你是在自动化服务器维护任务、在 VPS Hosting 环境中管理部署，还是为你的 web 服务器编写实用脚本，理解 shebang 的工作原理是每个系统管理员和开发人员都应该掌握的基础 Linux 技能。

本指南涵盖你需要了解的所有内容：shebang 是什么、如何在 Bash 和 Python 脚本中使用它们，以及将业余脚本与生产就绪自动化区分开来的最佳实践。

什么是 Shebang (#!)?

一个 shebang (也写作 *sha-bang*、*hashbang* 或 *pound-bang*) 是一个特殊的字符序列，放在脚本文件的第一行。它告诉 Linux 内核应该使用哪个解释器来执行文件的其余部分。

语法很简单：

#!/path/to/interpreter

当你运行一个脚本时，操作系统读取文件的前两个字节。如果它找到 #!，它会将文件传递给该行指定的解释器。没有 shebang，shell 可能会尝试使用自己的内置解释器执行脚本 — 这可能导致意外行为或彻底失败，特别是在混合语言时。

常见的 Shebang 示例

脚本类型Shebang 行
Bash#!/bin/bash
POSIX Shell#!/bin/sh
Python 3#!/usr/bin/env python3
Python 2 (遗留版本)#!/usr/bin/env python2
Perl#!/usr/bin/perl
Ruby#!/usr/bin/env ruby
Node.js#!/usr/bin/env node

为什么 /usr/bin/env 很重要

你会经常看到 shebang 以两种不同的风格编写：

#!/bin/python3

对比：

#!/usr/bin/env python3

第二种形式几乎总是首选。原因如下：

  • 可移植性：python3 的位置在不同的 Linux 发行版、macOS 和 BSD 系统中可能会有所不同。/usr/bin/env 搜索用户的 $PATH 来找到正确的解释器，无论它安装在哪里。
  • 虚拟环境：使用 Python 虚拟环境（venv）时，/usr/bin/env python3 会正确解析到 virtualenv 的 Python 二进制文件，而不是系统的。
  • 面向未来：如果解释器被更新或重新定位，使用 env 的脚本无需修改即可继续工作。

只有在你特别需要保证使用特定的二进制文件时，才应该使用硬编码的绝对路径（例如，#!/bin/bash）— 例如，在安全敏感的脚本中，$PATH 操纵可能是一个风险。

在 Bash 脚本中使用 Shebang：分步指南

让我们逐步完成从头开始创建一个完整的、可执行的 Bash 脚本。

第 1 步：打开终端

直接访问您的终端或通过 SSH 连接到您的 Linux 服务器。

第 2 步：创建新的 Bash 脚本文件

使用文本编辑器（例如 nano）创建新文件：

nano myscript.sh

第 3 步：添加 Shebang 和脚本内容

在文件的最顶部，添加 shebang 行，然后是您的脚本逻辑：

#!/bin/bash

# A simple greeting script
echo "Hello, World!"
echo "Current date and time: $(date)"
echo "Running as user: $(whoami)"

第 4 步：保存并退出

在 nano 中，按 CTRL + X，然后按 Y，然后按 Enter 以保存并关闭文件。

第 5 步：使脚本可执行

默认情况下，新创建的文件不可执行。使用 chmod 授予执行权限：

chmod +x myscript.sh

您可以使用以下命令验证权限更改：

ls -l myscript.sh

您应该看到类似的输出：

-rwxr-xr-x 1 user user 112 Jun 10 14:32 myscript.sh

第 6 步：运行脚本

从终端直接执行脚本：

./myscript.sh

预期输出：

Hello, World!
Current date and time: Tue Jun 10 14:32:01 UTC 2025
Running as user: youruser

> 注意： ./ 前缀告诉 shell 在当前目录中查找脚本。如果您的脚本目录已添加到 $PATH，您可以仅按名称运行脚本。

在 Python 脚本中使用 Shebangs：分步指南

Python 脚本遵循相同的模式，推荐的 shebang 行有一个关键区别。

步骤 1：创建新的 Python 脚本文件

nano myscript.py

步骤 2：添加 Shebang 和 Python 代码

#!/usr/bin/env python3

# A simple Python script demonstrating shebang usage
import sys
import platform

print("Hello from Python!")
print(f"Python version: {sys.version}")
print(f"Platform: {platform.system()} {platform.release()}")

步骤 3：保存、退出并使其可执行

# Save and exit nano with CTRL+X, Y, Enter
chmod +x myscript.py

步骤 4：运行脚本

./myscript.py

预期输出：

Hello from Python!
Python version: 3.11.2 (main, Mar 13 2023, 12:18:29)
Platform: Linux 5.15.0-76-generic

请注意，您不需要在命令前加上 python3 — shebang 会自动处理解释器选择。

实际现实应用示例

单独理解shebang是有用的，但将其应用于实际管理任务会使其价值更加清晰。

Bash：自动备份脚本

#!/bin/bash

# Automated backup script for web files
BACKUP_DIR="/var/backups/webfiles"
SOURCE_DIR="/var/www/html"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_FILE="$BACKUP_DIR/backup_$TIMESTAMP.tar.gz"

mkdir -p "$BACKUP_DIR"
tar -czf "$BACKUP_FILE" "$SOURCE_DIR"

echo "Backup completed: $BACKUP_FILE"

Python：系统健康检查脚本

#!/usr/bin/env python3

import shutil
import psutil

def check_disk_usage(path="/"):
    total, used, free = shutil.disk_usage(path)
    percent_used = (used / total) * 100
    print(f"Disk Usage ({path}): {percent_used:.1f}% used")
    if percent_used > 85:
        print("WARNING: Disk usage is critically high!")

def check_memory():
    mem = psutil.virtual_memory()
    print(f"Memory Usage: {mem.percent}% used")

check_disk_usage()
check_memory()

这些类型的脚本在管理基础设施时是无价的——无论您是运行单个共享虚拟主机账户还是在专用服务器上编排工作负载。

Shebang 行为：幕后发生了什么

当你执行带有 shebang 的脚本时，Linux 内核执行以下步骤：

  1. 读取文件的第一行并识别 #! 序列。
  2. 解析 shebang 行中的解释器路径（以及任何可选参数）。
  3. 调用解释器，将脚本文件作为参数传递。

例如，运行 ./myscript.py 在内部等同于：

/usr/bin/env python3 ./myscript.py

这就是为什么 shebang 必须始终位于第一行且前面没有空格 — 即使在它之前有一个空行也会导致 shebang 被忽略。

没有 Shebang 会发生什么？

如果不存在 shebang，行为取决于脚本的调用方式：

  • 如果以 ./script.py 的方式运行，当前 shell（例如 Bash）会尝试解释它，这对于 Python 代码会失败。
  • 如果以 python3 script.py 的方式运行，shebang 是无关的 — Python 被显式指定。
  • 如果以 bash script.sh 的方式运行，同样 shebang 被绕过。

shebang 仅在脚本直接执行时才重要（即以 ./script 的方式）。

高级Shebang技术

向解释器传递参数

您可以通过shebang行向解释器传递标志：

#!/bin/bash -e

-e 标志使Bash在任何命令失败时立即退出——这是生产脚本的常见安全做法。

#!/usr/bin/env python3 -u

-u 标志在Python中强制无缓冲输出，对实时日志记录很有用。

> 注意：某些系统在shebang行中的解释器路径后只支持单个参数。对于复杂的参数传递，最好在脚本本身内设置选项（例如，Bash中的 set -euo pipefail）。

使用 env 与特定版本

#!/usr/bin/env python3.11

这针对特定的Python版本，在多个版本共存的环境中很有用。

多语言脚本

在某些高级情况下，开发人员编写同时在多种语言中有效的脚本。shebang通过控制首先运行的解释器来实现这一点。虽然这是一种小众技术，但它展示了shebang提供的灵活性。

编写Shebang行的最佳实践

遵循这些最佳实践将使您的脚本更加健壮、可移植和易于维护 — 这在生产服务器环境中尤为重要。

1. 始终使用正确的解释器

将shebang与您的脚本所需的语言和版本相匹配：

#!/bin/bash          # For Bash-specific syntax
#!/bin/sh            # For POSIX-compliant shell scripts (more portable)
#!/usr/bin/env python3  # For Python 3 scripts

永远不要假设/bin/sh和/bin/bash是可互换的 — 它们不是。Bash支持POSIX sh不支持的功能（数组、[[ ]]、进程替换）。

2. 为了可移植性，优先使用/usr/bin/env

如前所述，使用env使脚本可以在不同系统和Python虚拟环境中移植。仅在安全性或特定性要求时才使用硬编码路径。

3. 始终设置执行权限

没有执行权限的脚本将失败并显示”Permission denied”错误：

chmod +x script.sh
chmod +x script.py

对于系统上所有用户都可以使用的脚本：

chmod 755 script.sh

4. 在专用目录中组织脚本

为个人脚本创建一个~/scripts或~/bin目录，并将其添加到您的$PATH：

mkdir -p ~/bin
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

之后，放置在~/bin中的任何可执行脚本都可以从任何地方按名称运行。

5. 添加有意义的注释

使用注释记录您的脚本，说明其目的、用法和任何依赖项：

#!/bin/bash
# Script: backup_web.sh
# Purpose: Creates timestamped backups of web root
# Usage: ./backup_web.sh
# Dependencies: tar, gzip
# Author: Your Name
# Last Modified: 2025-06-10

6. 为更安全的Bash脚本使用set选项

对于生产Bash脚本，在shebang之后立即添加这些安全选项：

#!/bin/bash
set -euo pipefail
  • -e：出错时退出
  • -u：将未设置的变量视为错误
  • -o pipefail：捕获管道命令中的错误

7. 在部署到生产环境之前测试脚本

在运行脚本到生产服务器之前，始终在开发或暂存环境中测试脚本。如果您需要一个隔离的测试环境，VPS Hosting计划提供了一个经济实惠的一次性沙箱，可以镜像生产条件。

排查常见Shebang问题

“Permission Denied”错误

bash: ./myscript.sh: Permission denied

解决方案：脚本缺少执行权限。运行 chmod +x myscript.sh。

“No Such File or Directory”错误

bash: ./myscript.py: /usr/bin/env: bad interpreter: No such file or directory

解决方案：Shebang中指定的解释器在该路径不存在。使用 which python3 或 which bash 验证。

脚本使用错误的解释器运行

症状：运行 .sh 文件时出现Python语法错误，反之亦然。

解决方案：确保shebang行在第1行，前面没有空格或空行，并且指向正确的解释器。

Windows行尾（rn）

如果在Windows上编辑脚本并将其传输到Linux，Windows风格的行尾可能会破坏shebang：

/bin/bash^M: bad interpreter

解决方案：使用 dos2unix 转换行尾：

dos2unix myscript.sh

服务器管理中的Shebang

对于任何管理基于Linux的托管基础设施的人来说，脚本编写能力是必不可少的。Shebangs是自动化的入口点——从简单的cron作业到复杂的部署管道。

考虑以下常见的服务器管理用例，其中编写正确的脚本（带有正确的shebangs）会产生可衡量的差异：

  • 自动化SSL证书续期 — 脚本化certbot续期和重启Web服务器。如果您正在手动管理证书，请考虑探索SSL证书以实现流畅的管理。
  • 日志轮转和清理 — Bash脚本按计划存档和清除旧日志。
  • 数据库备份 — Python脚本连接到MySQL/PostgreSQL，转储数据并上传到远程存储。
  • 健康监控 — 检查磁盘使用情况、内存和服务状态的脚本，当超过阈值时发送警报。
  • 部署自动化 — 从Git存储库拉取、运行测试和重启应用服务器的脚本。

对于机器学习管道或大规模数据处理脚本等资源密集型工作负载，您也可以考虑GPU托管以加速基于Python的计算。

快速参考：Shebang 速查表

# Bash (most common for shell scripts)
#!/bin/bash

# POSIX sh (maximum portability)
#!/bin/sh

# Bash with strict error handling (recommended for production)
#!/bin/bash
set -euo pipefail

# Python 3 (portable, uses PATH)
#!/usr/bin/env python3

# Python 3 with unbuffered output
#!/usr/bin/env python3 -u

# Perl
#!/usr/bin/perl

# Ruby
#!/usr/bin/env ruby

# Node.js
#!/usr/bin/env node

结论

Shebang 是支撑大量 Linux 自动化的一个看似简单但功能强大的机制。仅需两个字符 — #! — 和一个路径，就足以将纯文本文件转变为直接可执行的程序。

通过掌握 Bash 和 Python 脚本中的 shebang 用法，你将能够：

  • 编写可移植的、自包含的脚本，无论在什么环境中都能正确运行
  • 自信地自动化重复的管理任务
  • 构建健壮的部署和维护管道
  • 协作开发他人能够理解和执行的脚本，无需猜测

无论你是在共享虚拟主机上管理单个网站，还是在多个独立服务器上协调复杂的工作负载，脚本自动化都是你作为 Linux 管理员能够开发的最高杠杆技能之一。

从小处开始 — 编写一个脚本来自动化你今天手动执行的一项任务。添加正确的 shebang，设置权限，然后运行它。这就是每个伟大的自动化管道的开始方式。

所有托管服务节省 15%

测试技能，享折扣

使用代码： Skills 开始使用

相关常见问题解答

11 2 min
Linux

在科技界，很少有问题能引发如此多的争论：你到底怎么发音"Linux"？无论你是经验丰富的系统管理员、好奇的初学者，还是刚刚启动了第一个VPS Hosting环境的人，你很可能听过至少两三种不同的版本——也许你自己还为此争论过。

阅读更多
16.08.2025
10 3 min
Linux

Extra Packages for Enterprise Linux (EPEL) 存储库是一个宝贵的、由社区维护的高质量开源软件包集合，扩展了企业 Linux 发行版（如 CentOS、RHEL (Red Hat Enterprise Linux) 和 Fedora）上的默认软件。由 Fedora 项目维护，EPEL 填补了默认存储库留下的关键空白——提供系统管理员和开发人员每天依赖的实用程序、开发库、监控工具等。

阅读更多
30.10.2024
13 +1 5 min
Linux

Linux 二进制是存放可执行程序、系统管理工具和共享库的标准化文件系统位置。文件系统层次结构标准（FHS）定义了这些路径，以确保软件在各发行版中的一致性放置，从而实现可预测的 `PATH` 解析、干净的软件包管理以及可靠的系统恢复——即使在非必要文件系统不可用时也能正常运作。

阅读更多
09.10.2024