Mac执行python脚本commandnotfound怎么办

Aria
Aria
发布时间:2026-11-20| 4人浏览过
原创

在Mac终端运行Python脚本时遇到command not found报错,本文详细梳理报错原因,提供从临时执行、别名配置、Shebang修改到虚拟环境隔离的完整解决方法与避坑指南。

当你在 Mac 终端键入命令准备运行 Python 脚本时,如果屏幕上弹出一行 zsh: command not found: python 或 env: python: No such file or directory,核心原因是当前系统环境中没有名为 python 的可执行程序,或者环境变量中未能命中对应路径。在现代 macOS 系统中,解决此问题最直接的办法是:改用 python3 命令直接执行;若需要保留键入 python 的使用习惯,可在 Shell 配置文件 ~/.zshrc 中配置永久别名 alias python="python3";对于直接通过 ./script.py 运行的脚本,则需规范首行 Shebang 为 #!/usr/bin/env python3 并赋予执行权限。
Mac执行python脚本commandnotfound怎么办
图 0:Mac 终端执行 Python 脚本报错与快速修复全景一览

具体报错场景与核心原因剖析

在日常使用中,很多读者习惯按照旧有教程在 Mac 的终端(Terminal)或 iTerm2 中输入 python script.py,或者直接双击、以 ./script.py 方式执行脚本,但往往会遇到以下几种具体报错:

终端常见报错场景一览(示例)
场景 1:直接输入 python 命令调用脚本
zsh: command not found: python

场景 2:以 ./script.py 方式直接调用包含 Shebang 的脚本
env: python: No such file or directory

场景 3:执行权限缺失或相对路径查找受阻
zsh: permission denied: ./script.py

之所以出现上述现象,主要由 macOS 系统的底层机制演进与环境变量检索流程决定:

  • macOS 12.3 Monterey 的重大变迁: 在旧版本 macOS 中,苹果系统内置了 Python 2.7,存放在 /usr/bin/python。但自 macOS 12.3(2022 年春季发布)起,苹果彻底移除了内置的 Python 2.7 运行库,系统默认仅保留指向 Xcode 命令行开发工具的 python3 包装器,并不再提供任何名为 python 的原生二进制文件。
  • 默认 Shell 变更为 zsh: 自 macOS Catalina(10.15)开始,Mac 系统终端的默认 Shell 从 bash 改为了 zsh。很多用户在网上查阅的教程往往指导修改 ~/.bash_profile 或 ~/.bashrc,但在 zsh 环境下,这些文件不会自动加载,导致配置的环境变量无法生效。
  • $PATH 环境变量搜寻机制: 终端在接收到 python 命令时,会遍历 $PATH 中定义的一系列目录(如 /usr/local/bin、/opt/homebrew/bin、/usr/bin 等)。如果在所有列出的目录中均未发现名为 python 的可执行文件,zsh 就会抛出 command not found: python。
Mac执行python脚本commandnotfound怎么办
图 1:macOS 命令寻址机制与系统内置 Python 移除变迁原理

四步快速排查定位法

在动手修改任何配置之前,应当通过以下 4 个排查步骤确认系统当前的真实状态,从而对症下药:

第 1 步:确认系统是否存在 Python 3

在终端中输入以下命令,核实系统是否已经安装了 Python 3 解释器及其所在绝对路径:

which python3
python3 --version

此时观察终端的输出反馈:

排查第 1 步终端示例输出(正常装有 Python 3 时的表现)
$ which python3
/usr/bin/python3
$ python3 --version
Python 3.9.6

如果能够正常打印出版本号(如 Python 3.9.6 或 Python 3.12.x),说明机器上已经具备 Python 运行环境,问题仅仅是缺少 python 到 python3 的映射别名;如果终端提示 python3 not found 或弹出安装开发者工具提示框,则说明机器上尚未安装 Python 解释器。

第 2 步:核对当前使用的 Shell 类型

确认当前终端所使用的 Shell,确保后续配置文件修改在正确的文件中:

echo $SHELL

如果输出为 /bin/zsh(现代 Mac 默认),则对应配置文件为 ~/.zshrc;若仍在使用旧版 /bin/bash,对应配置文件为 ~/.bash_profile。

第 3 步:检查脚本的首行 Shebang 声明

如果你的报错是 env: python: No such file or directory,说明是通过 ./script.py 直接运行脚本。通过以下命令查看脚本首行:

head -n 1 script.py

若首行声明为 #!/usr/bin/env python 或 #!/usr/bin/python,由于当前系统中无 python,系统内核便无法拉起解释器。

第 4 步:核查文件可执行权限

通过长格式列表命令检查文件权限:

ls -l script.py

若文件权限标志位中缺少 x(如显示为 -rw-r--r--),直接使用 ./script.py 执行就会遭到系统拒绝,引发类似 permission denied 或找不到可执行主体的报错。

Mac执行python脚本commandnotfound怎么办
图 2:Mac 执行 Python 脚本报错排查与分流决策树

针对不同原因的四大解决方案

方案一:临时直接使用 python3 命令运行(最简便安全)

如果你只是临时需要运行一次脚本验证功能,最稳妥、不影响系统任何环境的做法就是直接使用 python3 命令替代原有的 python:

# 切换至脚本所在目录
cd ~/Documents/my_project

# 运行脚本
python3 script.py

该方法零侵入、不会对操作系统的 PATH 或配置文件造成任何副作用,特别适合初学者或临时测试任务。

方案二:在 ~/.zshrc 中配置持久别名(顺应输入习惯)

若习惯在键盘上直接敲入 python,并且希望每次新打开终端时都能自动调用 python3,可以通过为 zsh 添加别名(alias)实现。在终端中执行以下命令:

# 1. 向 ~/.zshrc 追加别名定义
echo 'alias python="python3"' >> ~/.zshrc

# 2. 重新加载配置文件使之立即生效
source ~/.zshrc

# 3. 验证是否配置成功
python --version

验证预期输出:终端应当正常打印出类似于 Python 3.x.x 的版本信息。注意:alias 只在交互式 Shell 终端中生效,若外部程序以独立子进程直接调用二进制文件,仍建议采用后续的完整路径配置或 Shebang 规范。

重要提醒:不要在 /usr/bin 下强行建立软链接!
部分网络旧教程建议执行 sudo ln -s $(which python3) /usr/bin/python。在 macOS 10.11 以后的所有系统中,/usr/bin 均处于 SIP(System Integrity Protection,系统完整性保护) 机制的绝对保护之下,执行该命令会提示 Operation not permitted。强行在 Recovery 模式关闭 SIP 来创建软链接不仅破坏系统安全防护,还可能在下一次 macOS 系统升级时被系统抹除。

方案三:若未安装 Python 3,通过 Homebrew 或官网安装

如果第 1 步排查发现系统中根本没有 python3,推荐通过 Mac 社区主流的包管理器 Homebrew 进行安装:

# 1. 通过 Homebrew 安装最新稳定版 Python 3
brew install python

# 2. 确认安装后的真实路径
which python3

不同硬件架构的 Mac,其 Homebrew 安装目录存在差别:

  • Apple Silicon 芯片(M1 / M2 / M3 / M4 系列):安装路径位于 /opt/homebrew/bin/python3。
  • Intel 架构机型:安装路径位于 /usr/local/bin/python3。

若发现安装后终端依旧提示找不到命令,请检查 ~/.zshrc 中是否导出了 Homebrew 环境变量。Apple Silicon 用户需确保文件末尾包含:

eval "$(/opt/homebrew/bin/brew shellenv)"

若不使用 Homebrew,读者亦可访问 Python 官方网站(python.org)下载 macOS 对应的 .pkg 官方安装包,双击按向导完成安装,官方安装包会自动将解释器软链接注册至 /usr/local/bin。

方案四:规范脚本首行 Shebang 并赋予可执行权限

如果你希望像独立可执行程序一样直接通过 ./script.py 运行脚本,必须保证脚本首行声明的解释器在系统中真实存在,并赋予其运行权限:

# 1. 打开脚本文件,将第一行修改为寻找 python3:
#!/usr/bin/env python3

# 2. 赋予脚本可执行权限 (chmod +x)
chmod +x script.py

# 3. 再次直接运行脚本
./script.py

#!/usr/bin/env python3 的好处在于它会动态通过系统的 $PATH 环境变量自动搜寻当前激活的 Python 3 解释器,无论是系统自带的、Homebrew 安装的,还是下文介绍的虚拟环境中的解释器,都能实现无缝兼容。

Mac执行python脚本commandnotfound怎么办
图 3:Mac 修复 Python 脚本执行环境四阶段操作流程

进阶规范:使用虚拟环境避免多版本冲突

在稍微复杂的项目开发中,如果直接向全局 Python 环境中安装第三方依赖包,极易引发依赖版本冲突。在现代 Python 3 环境下,推荐为每一个项目创建独立的虚拟环境(venv):

# 1. 在项目根目录下创建虚拟环境目录 .venv
python3 -m venv .venv

# 2. 激活虚拟环境
source .venv/bin/activate

# 3. 激活后命令行提示符前会显示 (.venv)
# 此时在该环境下,输入 python 会自动指向虚拟环境内部的解释器:
python script.py

# 4. 退出虚拟环境
deactivate

在虚拟环境处于激活状态时,虚拟环境的 bin 目录会自动被插入到 $PATH 的最前端。此时无论是执行 python 还是 pip,系统都会精准调用该虚拟环境专用的 Python 3 解释器,彻底规避 command not found 以及全局包污染问题。

常见疑问与避坑要点

问题现象 / 疑问 产生原因 正确应对方法
修改了 ~/.zshrc 后,当前窗口仍报 command not found 配置文件修改后仅写入磁盘,当前已打开的终端进程尚未重新读取该文件。 在当前终端中执行 source ~/.zshrc,或者完全退出当前终端后重新打开新窗口。
明明在 ~/.bash_profile 中写了 alias,但完全无效 macOS 默认 Shell 自 Catalina 开始全面采用 zsh,不会自动加载 bash 配置。 将配置迁移到 ~/.zshrc 中,或者在 ~/.zshrc 首行加入 source ~/.bash_profile。
执行 python3 时系统弹窗提示需要安装 Xcode 命令行工具 /usr/bin/python3 属于系统保留的轻量占位符,首次调用需要下载开发者组件。 点击弹窗中的“安装”按钮,耐心等待安装完毕;或直接在终端运行 xcode-select --install。
脚本双击打开时闪退或提示无默认程序 Mac Finder 默认将 .py 识别为纯文本文件,无法直接双击作为可执行文件运行。 请在终端中使用命令行运行,或在 Shebang 完备的前提下将扩展名临时调整为 .command。
Mac执行python脚本commandnotfound怎么办
图 4:Mac 执行 Python 脚本环境方案对比与避坑指南

总结与验证清单

Mac 终端执行 Python 脚本遇到 command not found,本质是系统由于安全和版本更迭移除了旧版 python 命令,而用户输入尚未与新版 python3 建立映射。在解决该问题后,可以通过以下检查清单验证环境是否已调整完毕:

  • 命令验证:在终端键入 python3 -V,能正确返回 Python 3.x.x 版本号。
  • 别名验证(若配置了 alias):新开一个终端标签页,键入 python -V,能正确映射并打印出 Python 3 版本。
  • 直接运行验证:脚本第一行为 #!/usr/bin/env python3,文件具有 +x 权限,键入 ./script.py 可以正常执行输出。

只要按照上述排查顺序与规范配置操作,即可彻底解决 Mac 终端下的命令缺失报错,并建立起清晰、合规的脚本开发与执行环境。

相关专题:

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

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 算法库。