Python

Python 环境搭建(VS Code 实测版)

蛋哥约 4 分钟0 阅读

Python · 2026-11-16 · 本文截图/出图均为真实运行结果

项目 / 值:

实例 1 环境自检:版本 / 位数 / 解释器路径
实例 1 环境自检:版本 / 位数 / 解释器路径
所属:基础教程 › Windows Python 入门|体例:实例式教程实跑说明:本篇代码与预期输出均在 Windows + VS Code(Python 3.13)中实跑核对,配 4 张真机界面截图,每张标出要看的输出行。适用平台:Windows|运行时:Python 3.13课序:第 2 篇|上一篇:Python-简介

环境声明

项目 / 值:

  • 适用平台:Windows
  • 运行时:Python 3.13 + VS Code
  • 要求使用应用:Visual Studio Code
  • 本篇创建的文件:check_env.py
  • 项目位置:读者本机自建的 receipt-desk 项目文件夹(VS Code 里打开的那个文件夹)
  • 依赖:前篇建好的 receipt-desk 项目目录
  • 截图说明:本篇实例截图均为 Windows + VS Code 真机运行界面,红圈标出要看的输出行

主线工程:receipt-desk

本篇创建的文件:check_env.py

先说两句

上一篇的代码已经能跑,说明环境是通的。这一篇回头补全"从零开始"的路径:装 Python、在 VS Code 里选对解释器。每一步都落到一个能运行的检查脚本上,装一步验一步,出问题时能立刻定位是哪一环断了。

实例 1:三行脚本问清环境底细

在 VS Code 里打开一个文件夹作为项目目录 receipt-desk(本线所有章节都用它),新建 check_env.py。三行代码,把最要紧的几件事一次问清:版本是多少、是不是 64 位、安装路径在哪。

import sys
import platform

print("版本:", platform.python_version())
print("位数:", "64-bit" if sys.maxsize > 2**32 else "32-bit")
print("解释器:", sys.executable)

预期输出结果(本机 Python 3.13 实跑核对;路径因安装方式不同而不同,你的版本号只要主版本是 3 就算通过):

版本: 3.13.17
位数: 64-bit
解释器: C:\Python313\python.exe

解释器那行各人不同,只要以 python.exe 结尾、主版本为 3.13 就算通过;这里示例是 C:\Python313\python.exe,装到别处会显示你自己的路径。

sys 和 platform 是标准库自带的模块,import 就能用,不用安装任何东西。如果运行时报 'python' 不是内部或外部命令,说明安装时没勾 PATH,跳到实例 3 的报错处理再回来。

实例 1 环境自检:版本 / 位数 / 解释器路径

实例 2:补上完成标记

自检脚本再加一行收尾标记,看到它就说明解释器、VS Code、当前目录三者已全部就位:

print("M2-OK")

把这一行加到 check_env.py 末尾再运行一次,预期输出结果(本机 Python 3.13 实跑核对):

M2-OK

sys 和 platform 之外不需要装任何东西。看到 M2-OK,环境底细就算验完了,后面章节的脚本都在这个目录里生长。

实例 2 运行输出:M2-OK

实例 3:在 VS Code 里选解释器

VS Code 右下角状态栏会显示当前 Python 解释器。按 Ctrl+Shift+P 输入 Python: Select Interpreter,列表里选中 3.13 那一行。

选完把 check_env.py 整个换成这一行再跑,看打印出来的路径和状态栏显示的是不是同一个:

import sys
print(sys.executable)

预期输出结果(本机实跑核对;能打印出以 python.exe 结尾的路径即通过):

C:\Python313\python.exe

这个路径就是"当前在用谁"。解释器那行各人不同,只要以 python.exe 结尾、主版本为 3.13 就算通过;这里示例是 C:\Python313\python.exe,装到别处会显示你自己的路径。VS Code 底部输出面板和右下角状态栏指向同一个解释器时,编辑器里的"运行"按钮和直接执行 python 的行为才不会分叉。

实例 3 解释器路径:sys.executable 指向 python.exe

实例 4(报错实例):PATH 没配时会看到什么

这一例不需要动手复现——本机 PATH 是配好的,正常情况下运行 check_env.py 永远得到实例 1 那样的正常输出。要认的是报错长什么样:如果哪天在 VS Code 里运行任何 Python 脚本,输出面板回的是下面这句话,问题就不在代码,在环境——

'python' 不是内部或外部命令,也不是可运行的程序或批处理文件。

两条路修好它:重跑安装器选 Modify,勾上 "Add Python to environment variables";或者系统设置里手动把 Python 安装目录加进 PATH 环境变量。改完重启 VS Code(旧的输出面板不会刷新 PATH),再跑一遍 check_env.py 确认。

实例 4 界面报错原文:'python' 不是内部或外部命令

小结

动作 / 说明:

  • check_env.py 三行自检:版本 / 位数 / 解释器路径一次问清
  • M2-OK 收尾标记:三者就位的完成信号
  • Ctrl+Shift+P 选解释器:VS Code 两处指向同一个 python.exe
  • 重启 VS Code:改 PATH 后必须,旧的输出面板不刷新
内容标记:未标记
返回阅读