Mac终端怎么执行python脚本

阿橙
阿橙
发布时间:2026-11-19| 6人浏览过
原创

详细介绍在Mac终端执行Python脚本的完整方法与实用技巧,涵盖终端环境验证、显式调用python3、Shebang直接执行机制对比、路径与参数传递,以及常见报错排查。

适用系统:macOS 12 / 13 / 14 及更新版本 运行环境:Terminal (zsh) / Python 3 难度级别:基础入门与实用进阶
Mac终端怎么执行python脚本

在 Mac 终端中执行 Python 脚本主要有两种标准途径:最常用且无需修改文件权限的方式是显式调用 Python 解释器,输入 python3 脚本路径 运行;另一类进阶方式是在脚本首行声明 Shebang 解释器路径并通过 chmod +x 赋予系统执行权限后,将其作为可执行程序直接执行(如 ./脚本名.py)。掌握这两种方法的操作细节、路径传参逻辑以及常见环境报错的排查策略,即可在 macOS 命令行中顺畅运行各类 Python 程序。

一、准备工作:打开终端与确认 Python 环境

在执行 Python 脚本前,需要先启动 Mac 内置的命令行工具并核验 Python 3 的安装状态。

1. 打开 Mac 终端(Terminal)

macOS 提供了两种最便捷的终端启动方式:

  • 聚焦搜索(推荐):按下快捷键 Command + 空格键,在弹出的搜索框中输入“终端”或“Terminal”,随后按回车键即可直接打开。
  • 访达目录启动:打开“访达(Finder)”,点击左侧边栏的“应用程序”,进入“实用工具”文件夹,双击“终端.app”。

2. 检查 Python 3 安装版本

现代 macOS 系统(自 macOS Monterey 12.3 起)已完全移除了历史内置的 Python 2.7 解释器。若直接输入 python,系统通常会提示 zsh: command not found: python。因此,在 Mac 终端中应当统一使用 python3 指令。

在终端光标处输入以下命令并按回车:

终端 — 检查 Python 版本
macbook@local ~ % python3 --version
Python 3.11.8 # 示例输出:如果已正确安装,终端将返回具体的 Python 3 版本号

如果终端弹出提示需要安装 Xcode 命令行开发者工具(Command Line Tools),点击“安装”并根据系统指引完成安装即可,系统会自动配置好基础的 python3 运行环境。若需要更新或管理多个 Python 版本,亦可通过 Homebrew 官方包管理器执行 brew install python 补充安装。

Mac终端怎么执行python脚本
图 1:Mac 终端执行 Python 脚本的核心四步标准流程

二、基础操作:显式调用 python3 解释器执行

显式调用是执行 Python 脚本最通用、最安全的操作方式。其运行原理是让终端直接拉起系统或环境中的 python3 解释器进程,并将目标脚本的文件路径作为参数传递给解释器进行逐行语法解析和执行。根据脚本所在路径的处理方式,分为以下两种具体操作场景:

场景 A:使用 cd 切换到目标目录后执行(相对路径)

当脚本文件存放在某个特定文件夹(例如文稿目录中的项目文件夹)中,建议先切换终端的当前工作目录(Current Working Directory)。这样可以使终端环境与代码所在的物理路径对齐,脚本若内部需要读取同级目录下的文本、配置或数据文件(如 open("config.json")),相对路径查找便不会出错。

假设在桌面创建了一个名为 hello.py 的文件,内容如下:

hello.py 示例源码
# hello.py 内容示例
print("你好,这是在 Mac 终端中运行的 Python 脚本!")

在终端中分步输入以下命令:

终端 — cd 切换目录并执行
# 1. 切换到桌面目录
macbook@local ~ % cd ~/Desktop

# 2. 运行脚本
macbook@local Desktop % python3 hello.py
你好,这是在 Mac 终端中运行的 Python 脚本!

场景 B:在任意目录下直接执行(绝对路径与访达拖拽技巧)

如果只是想快速测试某个脚本,而无需手动一层层输入目录路径,可以使用绝对路径运行。Mac 终端具备优秀的拖拽交互支持:

  1. 在终端窗口中先输入 python3 (注意:python3 后面必须键入一个空格)。
  2. 打开“访达(Finder)”,找到你的 .py 脚本文件。
  3. 用鼠标按住该脚本文件,直接拖入到终端窗口的光标处并松开。
  4. 终端会自动将该文件的绝对路径补全在命令行中,并自动转义路径中包含的空格或特殊字符。
  5. 按下回车键,脚本即可立即运行。
终端 — 绝对路径执行示例
macbook@local ~ % python3 /Users/username/Desktop/hello.py
你好,这是在 Mac 终端中运行的 Python 脚本!
Mac终端怎么执行python脚本
图 2:相对路径与绝对路径定位机制及路径空格转义规则

三、进阶操作:配置 Shebang 赋予权限直接运行

在类 Unix 系统(包括 macOS)中,除了每次输入 python3 命令外,还可以将 Python 脚本打造成类似于系统二进制指令的独立可执行脚本。其核心在于利用 Unix 内核对脚本首行“释伴(Shebang)”机制的支持。

1. 配置 Shebang 声明行

使用文本编辑器或代码编辑器打开 Python 文件,在文件的最开头第一行写入以下指令:

myscript.py — 首行 Shebang 配置
#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import sys
print(f"脚本已作为独立可执行文件运行,当前解释器位置: {sys.executable}")
为什么推荐使用 #!/usr/bin/env python3 而非固定路径?
在 Mac 上,系统自带的 Python3 可能位于 /usr/bin/python3,Homebrew 安装的可能位于 /opt/homebrew/bin/python3(Apple Silicon 芯片)或 /usr/local/bin/python3(Intel 芯片)。借助 /usr/bin/env python3,系统会自动查找当前环境变量 $PATH 中优先级最高、正在激活的 Python 解释器,极大提升了脚本的兼容性与便携性。

2. 赋予脚本执行权限(chmod +x)

Mac 出于安全性考虑,默认新建的代码文本文件仅具有读取和写入权限,没有执行权限。如果直接运行会收到 zsh: permission denied 错误。必须先在终端中执行授权命令:

终端 — 赋予执行权限并直接运行
# 1. 赋予该脚本当前用户的可执行权限
macbook@local Desktop % chmod +x myscript.py

# 2. 直接运行(注意当前目录下的脚本必须前置 ./)
macbook@local Desktop % ./myscript.py
脚本已作为独立可执行文件运行,当前解释器位置: /usr/bin/python3

这里的 ./ 表示“在当前目录寻找该可执行文件”。这是 Unix 系统的安全保护机制,防止用户无意间执行了与系统核心指令同名的恶意本地脚本。

3. 两种执行模式的关键差异对比

为了帮助理解这两种方式在实际工程中的选择逻辑,在一致的 macOS 终端环境下,将两者在几个关键维度的表现对照如下:

对照维度 显式解释器调用(python3 script.py) Shebang 直接执行(./script.py)
文件权限要求 仅需读权限(-r-- 或 -rw-),新建文件可直接运行。 必须具备读与可执行权限(-rwxr-xr-x),需要显式执行 chmod +x。
环境调度主体 由终端调用者明确指定(可随时更换为特定的 Python 二进制文件或虚拟环境)。 由文件首行的 Shebang 指定,封装度高,调用者无需关心其内部实现语言。
启动与调用形式 必须前置解释器命令,例如 python3 script.py。 如同原生可执行程序,直接键入 ./script.py,支持放入 PATH 作为全局命令。
主要适用场景 日常代码开发、调试测试、多虚拟环境频繁切换的敏捷验证。 自制系统运维工具、自动化部署流程、交付给其他 Shell 脚本管道串联调用。
Mac终端怎么执行python脚本
图 3:显式解释器调用与 Shebang 独立脚本运行机制对比

四、实用操作:终端参数传递与交互控制

在终端中运行脚本时,经常需要动态向 Python 脚本传入运行时参数,或控制脚本的运行生命周期。

1. 接收终端命令行参数(sys.argv)

在终端执行命令时,紧跟在脚本文件名之后用空格分隔的字符串,都会作为参数依次传递给 Python 程序。例如脚本 task.py:

task.py 源码
import sys

# sys.argv[0] 是脚本本身名称,后续索引对应传入的参数
print(f"收到参数列表: {sys.argv}")
if len(sys.argv) > 1:
    print(f"处理任务: {sys.argv[1]}")
终端 — 传递参数执行
macbook@local Desktop % python3 task.py clean_cache --verbose
收到参数列表: ['task.py', 'clean_cache', '--verbose']
处理任务: clean_cache

2. 运行过程中的快捷键与进程控制

  • 中断运行(强制停止):当运行包含死循环、网络监听或耗时任务的脚本时,按下快捷键 Ctrl + C,终端会向 Python 发送中断信号(KeyboardInterrupt),安全终止当前执行流程。
  • 后台静默运行:如果希望脚本在后台运行而不阻塞当前终端,可以在命令末尾添加 & 符号,例如 python3 server.py &。
  • 清屏操作:在多次执行调试后,按下快捷键 Command + K 或输入 clear 命令可清空终端屏幕历史显示。

五、常见报错排查与解决方法

在初次或跨目录使用 Mac 终端运行 Python 脚本时,常会遇到几种典型的终端报错。以下是对应的成因剖析与解决手段:

1. 提示 zsh: command not found: python

原因:macOS 自 12.3 起不再附带旧版 Python 2,系统默认并没有注册名为 python 的别名软链接。
解决:始终改用 python3 执行。若希望输入 python 时自动映射到 Python 3,可在用户的 Shell 配置文件(~/.zshrc)中添加别名:alias python=python3,保存后执行 source ~/.zshrc 生效。

2. 提示 zsh: permission denied: ./script.py

原因:使用直接运行模式时,操作系统检查到该文件不包含可执行(Execute)权限。
解决:在终端输入 chmod +x script.py 添加执行权限后再运行;或者改用 python3 script.py 显式调用,无需更改权限即可直接读取。

3. 提示 python3: can't open file 'xxx.py': [Errno 2] No such file or directory

原因:终端当前所在的工作目录与脚本文件所在的物理位置不匹配,或者文件名拼写有误。
解决:在终端输入 pwd 打印当前工作目录,输入 ls 检查当前目录下是否存在该脚本。若路径层级较深,推荐先输入 python3 后,直接从访达将脚本文件拖拽入终端,避免手动拼写错误。

4. 提示 ModuleNotFoundError: No module named 'xxx'

原因:脚本中通过 import 引入的第三方库未安装在当前调用的 Python 环境中,常见于多版本 Python 或未激活项目虚拟环境(virtualenv)的情况。
解决:先在终端输入 which python3 确认当前终端正在使用的是哪个 Python 路径。若是项目工程,应先执行激活命令(例如 source venv/bin/activate);若需全局安装模块,执行 python3 -m pip install 模块名 确保依赖准确安装到当前解释器目录下。

Mac终端怎么执行python脚本
图 4:Mac 终端执行 Python 脚本决策与排错全景总结流程图

六、总结

在 Mac 终端中运行 Python 脚本的整个体系十分清晰规范:对于日常开发与快速测试,优先使用 cd 切换到代码目录并执行 python3 script.py,或者借助访达拖拽获得准确的绝对路径;对于工具化封装或系统任务,在脚本首行添加 #!/usr/bin/env python3 并执行 chmod +x,即可像原生程序一样直接运行。遇到问题时,沿着版本检查、路径核对、权限确认和依赖环境定位四步排查,便能高效解决绝大多数终端运行问题。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。