如何通过自定义命令执行指定的Python脚本？

前置准备 #

先确认你的Python脚本本身可以正常运行：执行python /path/to/your/script.py（替换为你自己的脚本路径）没有报错，再进行后续配置。

macOS / Linux 配置步骤 #

• 给脚本第一行添加shebang声明，指定Python解释器：

  #!/usr/bin/env python3
  

• 给脚本添加可执行权限：chmod +x /path/to/your/script.py
• 如果你希望命令名为run，将脚本重命名为run，去掉.py后缀
• 编辑当前shell的配置文件（bash用户编辑~/.bashrc，zsh用户编辑~/.zshrc），在末尾添加如下内容，将脚本所在的目录加入PATH环境变量：

  export PATH="$PATH:/替换为你自己的脚本所在文件夹的绝对路径"
  

• 执行source ~/.bashrc（对应你用的shell配置文件）让配置即时生效
• 新开终端窗口，输入run即可直接运行对应的Python脚本

Windows 配置步骤 #

方法1：修改环境变量直接调用 #

• 把你的Python脚本重命名为run.py
• 右键「此电脑」-「属性」-「高级系统设置」-「环境变量」
• 在「用户变量」或「系统变量」列表中找到Path，点击「编辑」，新建一条，填入你脚本所在文件夹的完整路径，依次点击确定保存
• 同样在环境变量列表中找到PATHEXT，点击「编辑」，在末尾添加.PY，依次点击确定保存
• 新开cmd/PowerShell窗口，输入run即可直接运行脚本

方法2：通过批处理文件映射（无需修改PATHEXT，兼容性更好） #

• 在任意你喜欢的目录下新建文本文档，写入如下内容：

  @echo off
  python "替换为你的Python脚本的完整绝对路径" %*
  

  其中%*作用是把你输入命令时附带的参数传递给Python脚本，不需要传参可以删掉
• 将这个文本文档重命名为run.bat
• 按照方法1的步骤，把run.bat所在的文件夹路径添加到Path环境变量中，保存配置
• 新开cmd/PowerShell窗口，输入run即可测试运行

常见问题排查 #

• 提示「找不到命令」：执行echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认你的脚本/批处理文件所在目录已经被正确加入PATH，配置后记得重启终端生效
• 运行时报错权限不足：macOS/Linux确认已经执行过chmod +x给脚本加可执行权限，Windows确认脚本没有被系统安全机制拦截
• Python版本不匹配：把命令中的python替换为对应版本的绝对路径即可，比如/usr/bin/python3.10或C:\Python39\python.exe

内容的提问来源于stack exchange，提问作者Cl1m