运行Python脚本如何在Windows终端执行基础脚本文件 运行Python脚本的Windows终端操作技巧

最直接的方法是先用cd命令进入脚本所在目录，再输入python 脚本名.py执行；前提是python已正确安装并配置环境变量，否则需手动将python安装路径添加到path中；若遇到“’python’ 不是内部或外部命令”错误，通常是因为未将python加入环境变量；可通过python –version检查安装情况，并通过echo %path%确认路径是否包含python安装目录；执行脚本时也可使用py启动器来兼容多版本python；常见错误如modulenotfounderror需通过pip安装对应库，nameerror需检查变量名拼写和作用域，syntaxerror则关注括号、冒号和缩进问题；逻辑错误可通过print()或调试工具排查；为避免项目间依赖冲突，推荐使用虚拟环境，通过python -m venv venv创建，.venvscriptsactivate激活，deactivate退出，从而实现项目依赖的隔离管理。

在Windows终端运行Python脚本，最直接的方法就是先通过

cd

命令进入到脚本所在的目录，然后用

python 你的脚本名.py

来执行它。这听起来可能有点像老生常谈，但其中一些细节，尤其是对于初学者来说，往往是绊脚石。

解决方案

其实，把Python脚本跑起来，远没有想象中那么复杂，但一些基础的准备工作和操作步骤是绕不开的。

首先，你得确保Python已经在你的系统上安家落户了。打开Windows终端（你可以直接在开始菜单里搜索“终端”或者“cmd”，甚至Win+X菜单里也有），敲入

python --version

。如果看到一串数字，比如

Python 3.9.7

，那恭喜你，基础环境是OK的。如果提示“’python’ 不是内部或外部命令”，那说明Python还没被系统识别，或者说没加到环境变量里，这通常是安装时漏勾了“Add Python to PATH”选项。

立即学习“Python免费学习笔记（深入）”；

接着，就是定位你的脚本文件。假设你的脚本叫

my_script.py

，放在

C:UsersYourNameDocumentsPythonScripts

这个路径下。在终端里，你需要用

cd

命令切换过去：

cd C:UsersYourNameDocumentsPythonScripts

当然，你也可以直接把脚本文件拖到终端窗口里，它会自动帮你补全路径，然后你在路径前面加上

python

和空格就行。

最后，执行脚本。在脚本所在的目录下，直接输入：

python my_script.py

回车，脚本就开始运行了。如果脚本有输出，结果就会直接显示在终端里。有时候，你可能还会看到有人用

py my_script.py

来执行，这在Windows上也很常见，

py

是Python安装时自带的一个启动器，它能智能地选择合适的Python版本来运行脚本，尤其在你安装了多个Python版本时会很有用。

Python环境变量配置：为何它如此关键？

我发现很多初学者在运行Python脚本时，最常遇到的问题就是“’python’ 不是内部或外部命令”。这几乎百分之九十的情况都指向了一个地方：Python的环境变量没有配置好。简单来说，环境变量就是告诉操作系统去哪里找你输入的命令。当你在终端里敲下

python

时，系统会去PATH环境变量里列出的所有路径里挨个找，看有没有一个叫

python.exe

的可执行文件。如果找不到，自然就报错了。

所以，把Python添加到PATH，就意味着你可以在任何目录下直接输入

python

来调用解释器，而不用每次都跑到Python的安装目录下去。这大大提升了便利性。

怎么检查呢？除了前面说的

python --version

，你也可以直接在终端里输入

echo %PATH%

，看看输出的一长串路径里有没有Python的安装路径，通常会有类似

C:UsersYourNameAppDataLocalProgramsPythonPython39

和

C:UsersYourNameAppDataLocalProgramsPythonPython39Scripts

这样的路径。如果缺失了，你就得手动去“系统属性”->“高级”->“环境变量”里，找到“Path”变量，然后把Python的安装路径和其下的Scripts路径加进去。这个步骤虽然有点繁琐，但做一次就能一劳永逸。

脚本执行错误：常见问题与排查思路

脚本跑不起来，或者跑起来不对劲，这是家常便饭。作为开发者，解决问题本身就是工作的一部分。最常见的错误，大概就是Python给你抛出的那些“Traceback”信息了。别怕它长，那里面藏着宝藏。

• ModuleNotFoundError: No module named 'some_module'

  ：这个太常见了。意味着你的脚本里

  import

  了一个Python找不到的库。通常是你忘记安装了，比如

  pip install some_module

  。有时候也可能是虚拟环境没激活，或者安装到了错误的Python版本下。

• NameError: name 'some_variable' is not defined

  ：变量名写错了，或者在使用前没定义。仔细检查变量拼写，以及变量的作用域。

• SyntaxError: invalid syntax

  ：语法错误。通常是括号没闭合、冒号忘了加、缩进不对等等。Python对缩进非常敏感，一个空格或Tab的差异都可能导致问题。Traceback会告诉你具体在哪一行。

• 逻辑错误：脚本能跑，但不按预期工作。这种最麻烦，因为Python不报错。这时候，我通常会用

  print()

  语句大法，在关键位置打印变量的值，看看程序执行到哪里，数据是什么样的。或者，更专业的，用Python自带的

  pdb

  调试器，或者VS Code等IDE的调试功能，一步步跟踪代码执行。

排查问题，核心就是看报错信息，然后结合自己的代码逻辑去分析。很多时候，一个简单的拼写错误就能让你抓狂半小时。保持耐心，是解决问题的关键。

虚拟环境：隔离项目依赖的利器

当你开始接触多个Python项目时，很快就会发现一个头疼的问题：项目A需要库X的1.0版本，而项目B却需要库X的2.0版本。直接在系统全局Python环境里安装，很容易造成版本冲突，导致一些项目无法运行。这时候，虚拟环境（Virtual Environment）就显得尤为重要了。

虚拟环境可以理解为一个独立的、隔离的Python运行环境。每个虚拟环境都有自己独立的Python解释器和一套库。这样，你就可以为每个项目创建一个独立的虚拟环境，在里面安装项目所需的特定版本库，而不会影响到其他项目或全局环境。

在Windows终端里使用虚拟环境，通常是这样的：

1. 创建虚拟环境： 在你的项目文件夹下（比如

   my_project

   ），打开终端，运行：

   python -m venv venv

   这里

   venv

   是虚拟环境的名称，你可以改成

   env

   、

   .venv

   等任何你喜欢的名字。

2. 激活虚拟环境： 创建后，你需要激活它才能使用。在Windows上，激活命令是：

   .venvScriptsactivate

   激活成功后，你的终端提示符前面会多一个

   (venv)

   字样，表示你当前正处于这个虚拟环境中。

3. 安装依赖： 在激活的虚拟环境中，你可以像往常一样使用

   pip

   安装库：

   pip install requests

   这些库只会安装到当前激活的虚拟环境中。

4. 退出虚拟环境： 当你想切换到其他项目或回到全局环境时，直接输入：

   deactivate

   提示符前面的

   (venv)

   就会消失。

使用虚拟环境，虽然多了一步激活操作，但它能极大地避免依赖冲突，让你的项目管理变得井井有条。这是我个人在日常开发中非常推崇的一个习惯，它能省去很多不必要的麻烦。