第1章：Python初体验——搭建你的开发环境
章节介绍
欢迎来到Python的世界！在开始编写任何代码之前，我们需要一个稳定、独立的工作空间，这就是开发环境。一个配置得当的环境能让你专注于学习，避免很多不必要的麻烦。
让我们先看看自己的起点在哪里。运行一个简单的命令，就能获取当前系统的基础信息，比如操作系统类型和Python的安装路径，这有助于后续的针对性配置。
def print_welcome_message() -> None:
"""
打印欢迎信息，显示Python开发环境的基本信息。
"""
import sys
import platform
print("=" * 50)
print("欢迎使用Python开发环境！")
print("=" * 50)
print(f"操作系统: {platform.system()} {platform.version()}")
print(f"Python版本: {sys.version}")
print(f"Python解释器位置: {sys.executable}")
print("=" * 50)
print("运行 'run_simple_test()' 进行环境测试。")
print("运行 'get_system_info()' 查看详细系统信息。")
print("运行 'get_pip_packages()' 查看已安装的包。")
print("=" * 50)
通常，Python 3.6 或更高版本能提供更好的语言特性和库支持。我们可以立刻检查一下当前环境是否符合这个基础要求。
def check_python_version(min_version: tuple = (3, 6)) -> bool:
"""
检查当前Python版本是否满足最低要求版本。
参数:
min_version (tuple): 最低要求的Python版本，默认为(3, 6)。
返回:
bool: 如果当前Python版本满足或高于最低要求，返回True，否则返回False。
"""
import sys
# 获取当前Python版本
current_version = sys.version_info[:2]
# 比较版本
if current_version >= min_version:
print(f"Python版本检查通过: 当前版本 {'.'.join(map(str, current_version))} "
f">= 最低要求 {'.'.join(map(str, min_version))}")
return True
else:
print(f"Python版本检查失败: 当前版本 {'.'.join(map(str, current_version))} "
f"< 最低要求 {'.'.join(map(str, min_version))}")
return False
直接在本机安装包可能会引起不同项目间的版本冲突。为了解决这个问题，Python 提供了“虚拟环境”这一工具，它能为你当前的每一个项目创建一个独立的、干净的 Python 运行空间。想象一下，它就像为你的项目单独准备了一个工具箱，里面的工具（第三方库）不会和其他项目的混在一起。
下面，我们就在当前目录下创建一个名为 venv 的虚拟环境。
def create_virtual_env(env_name: str = "venv") -> bool:
"""
在当前目录下创建Python虚拟环境。
参数:
env_name (str): 虚拟环境的名称，默认为"venv"。
返回:
bool: 创建成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查是否已存在同名虚拟环境
if os.path.exists(env_name):
print(f"虚拟环境 '{env_name}' 已存在。")
return False
try:
# 使用当前Python解释器创建虚拟环境
subprocess.run([sys.executable, "-m", "venv", env_name], check=True)
print(f"虚拟环境 '{env_name}' 创建成功。")
return True
except subprocess.CalledProcessError as e:
print(f"创建虚拟环境时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
创建好环境后，别忘了激活它。在 Windows 系统的命令行中，使用 venv\Scripts\activate；在 macOS 或 Linux 系统的终端中，使用 source venv/bin/activate。激活后，你通常会看到命令提示符前出现了 (venv) 标记，这表示你已经进入了这个独立的空间。
在实际项目中，我们常常会依赖很多别人写好的代码库，比如用来做数据分析的 pandas，或者用来构建网站的 Django。这些依赖通常被记录在一个名为 requirements.txt 的文件里。如何一次性安装它们呢？
def install_requirements(requirements_file: str = "requirements.txt") -> bool:
"""
使用pip安装requirements.txt文件中列出的依赖包。
参数:
requirements_file (str): requirements.txt文件的路径，默认为当前目录下的"requirements.txt"。
返回:
bool: 安装成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查requirements.txt文件是否存在
if not os.path.exists(requirements_file):
print(f"文件 '{requirements_file}' 不存在。")
return False
try:
# 使用pip安装依赖
subprocess.run([sys.executable, "-m", "pip", "install", "-r", requirements_file], check=True)
print(f"依赖包安装成功。")
return True
except subprocess.CalledProcessError as e:
print(f"安装依赖包时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
怎么确认一个包是否已经安装成功？或者想看看当前环境里都有哪些“工具”？
def check_package_installed(package_name: str) -> bool:
"""
检查指定的Python包是否已安装。
参数:
package_name (str): 要检查的包名。
返回:
bool: 如果包已安装则返回True，否则返回False。
"""
import importlib.util
# 使用importlib检查包是否存在
spec = importlib.util.find_spec(package_name)
if spec is not None:
print(f"包 '{package_name}' 已安装。")
return True
else:
print(f"包 '{package_name}' 未安装。")
return False
def get_pip_packages() -> list:
"""
获取当前环境中通过pip安装的所有包及其版本。
返回:
list: 包含字典的列表，每个字典包含'name'和'version'键。
"""
import subprocess
import sys
try:
# 运行pip list命令获取包列表
result = subprocess.run([sys.executable, "-m", "pip", "list", "--format=freeze"],
capture_output=True, text=True, check=True)
packages = []
for line in result.stdout.strip().split('\n'):
if line:
# 每行格式为"package==version"
if '==' in line:
name, version = line.split('==')
packages.append({"name": name, "version": version})
return packages
except subprocess.CalledProcessError as e:
print(f"获取包列表时出错: {e}")
return []
except Exception as e:
print(f"未知错误: {e}")
return []
所有设置都完成后，怎样才算环境真正准备好了？我们来运行一个最简单的测试程序，它会尝试执行一些基本操作，验证环境是否能够正常运行代码。
def run_simple_test() -> bool:
"""
运行一个简单的Python程序测试开发环境是否正常工作。
返回:
bool: 测试通过返回True，失败返回False。
"""
try:
# 简单的测试代码：计算并打印结果
result = 2 + 3 * 4
print(f"简单测试: 2 + 3 * 4 = {result}")
# 测试导入标准库
import math
print(f"数学库测试: π的近似值为 {math.pi}")
# 测试字符串操作
test_string = "Hello, Python!"
print(f"字符串测试: {test_string}")
print("开发环境测试通过！")
return True
except Exception as e:
print(f"开发环境测试失败: {e}")
return False
如果测试顺利通过，那么恭喜你，一个专属于你的 Python 工作台已经搭建完毕。这个独立、干净的环境是你学习和探索的起点，从这里开始，你就可以安心地尝试各种代码而不用担心弄乱系统了。
核心概念
准备好写你的第一个Python程序了吗？别急，一个好的开始离不开一个合适的“工作台”。我们先来确保你的电脑已经准备好了所有必要的工具。
第一步，也是最基础的一步，是确认你的Python版本。Python有2.x和3.x两个主要的分支，现在的主流和未来都在3.x上。我们可以用一个简单的工具来检查：
def check_python_version(min_version: tuple = (3, 6)) -> bool:
"""
检查当前Python版本是否满足最低要求版本。
参数:
min_version (tuple): 最低要求的Python版本，默认为(3, 6)。
返回:
bool: 如果当前Python版本满足或高于最低要求，返回True，否则返回False。
"""
import sys
# 获取当前Python版本
current_version = sys.version_info[:2]
# 比较版本
if current_version >= min_version:
print(f"Python版本检查通过: 当前版本 {'.'.join(map(str, current_version))} "
f">= 最低要求 {'.'.join(map(str, min_version))}")
return True
else:
print(f"Python版本检查失败: 当前版本 {'.'.join(map(str, current_version))} "
f"< 最低要求 {'.'.join(map(str, min_version))}")
return False
这个函数会告诉你当前Python的版本是否满足最低要求（比如3.6）。如果版本太旧，你需要去Python官网下载并安装最新版本。
安装好Python后，我们通常会创建一个“虚拟环境”。这就像是为你的项目建立一个独立的房间，房间里的家具（第三方库）只属于这个项目，不会和其他项目的搞混。这样能避免版本冲突的问题。创建虚拟环境很简单：
def create_virtual_env(env_name: str = "venv") -> bool:
"""
在当前目录下创建Python虚拟环境。
参数:
env_name (str): 虚拟环境的名称，默认为"venv"。
返回:
bool: 创建成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查是否已存在同名虚拟环境
if os.path.exists(env_name):
print(f"虚拟环境 '{env_name}' 已存在。")
return False
try:
# 使用当前Python解释器创建虚拟环境
subprocess.run([sys.executable, "-m", "venv", env_name], check=True)
print(f"虚拟环境 '{env_name}' 创建成功。")
return True
except subprocess.CalledProcessError as e:
print(f"创建虚拟环境时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
运行后，当前目录下会生成一个名为“venv”（或你指定的名字）的文件夹，这就是你的独立空间了。
虚拟环境建好了，但里面是空的。一个项目往往需要依赖很多别人写好的“轮子”，也就是第三方库。这些库通常列在一个叫requirements.txt的文件里。我们可以这样一次性把它们都安装进来：
def install_requirements(requirements_file: str = "requirements.txt") -> bool:
"""
使用pip安装requirements.txt文件中列出的依赖包。
参数:
requirements_file (str): requirements.txt文件的路径，默认为当前目录下的"requirements.txt"。
返回:
bool: 安装成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查requirements.txt文件是否存在
if not os.path.exists(requirements_file):
print(f"文件 '{requirements_file}' 不存在。")
return False
try:
# 使用pip安装依赖
subprocess.run([sys.executable, "-m", "pip", "install", "-r", requirements_file], check=True)
print(f"依赖包安装成功。")
return True
except subprocess.CalledProcessError as e:
print(f"安装依赖包时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
有时候，你可能想看看这个环境里已经装了些什么，或者检查某个特定的包（比如常用于科学计算的numpy）是否已经存在。这时候可以用这两个方法：
def get_pip_packages() -> list:
"""
获取当前环境中通过pip安装的所有包及其版本。
返回:
list: 包含字典的列表，每个字典包含'name'和'version'键。
"""
import subprocess
import sys
try:
# 运行pip list命令获取包列表
result = subprocess.run([sys.executable, "-m", "pip", "list", "--format=freeze"],
capture_output=True, text=True, check=True)
packages = []
for line in result.stdout.strip().split('\n'):
if line:
# 每行格式为"package==version"
if '==' in line:
name, version = line.split('==')
packages.append({"name": name, "version": version})
return packages
except subprocess.CalledProcessError as e:
print(f"获取包列表时出错: {e}")
return []
except Exception as e:
print(f"未知错误: {e}")
return []
def check_package_installed(package_name: str) -> bool:
"""
检查指定的Python包是否已安装。
参数:
package_name (str): 要检查的包名。
返回:
bool: 如果包已安装则返回True，否则返回False。
"""
import importlib.util
# 使用importlib检查包是否存在
spec = importlib.util.find_spec(package_name)
if spec is not None:
print(f"包 '{package_name}' 已安装。")
return True
else:
print(f"包 '{package_name}' 未安装。")
return False
环境搭建好了，怎么知道它能不能正常工作呢？最好的办法就是跑一个最简单的程序试试。比如，打印一句经典的问候：
def run_simple_test() -> bool:
"""
运行一个简单的Python程序测试开发环境是否正常工作。
返回:
bool: 测试通过返回True，失败返回False。
"""
try:
# 简单的测试代码：计算并打印结果
result = 2 + 3 * 4
print(f"简单测试: 2 + 3 * 4 = {result}")
# 测试导入标准库
import math
print(f"数学库测试: π的近似值为 {math.pi}")
# 测试字符串操作
test_string = "Hello, Python!"
print(f"字符串测试: {test_string}")
print("开发环境测试通过！")
return True
except Exception as e:
print(f"开发环境测试失败: {e}")
return False
如果程序成功运行并输出了结果，那恭喜你，环境已经就绪了！
在整个过程中，如果你想了解一下“工作台”的基本信息，比如操作系统、Python路径等，可以随时查看：
def get_system_info() -> dict:
"""
获取当前系统的基本信息。
返回:
dict: 包含系统信息的字典，包括平台、Python版本等。
"""
import sys
import platform
system_info = {
"platform": platform.system(),
"platform_version": platform.version(),
"python_version": sys.version,
"python_version_info": {
"major": sys.version_info.major,
"minor": sys.version_info.minor,
"micro": sys.version_info.micro
},
"machine": platform.machine(),
"processor": platform.processor()
}
return system_info
最后，当你完成所有这些步骤，一个包含了环境概览的欢迎信息会让你对当前的配置一目了然：
def print_welcome_message() -> None:
"""
打印欢迎信息，显示Python开发环境的基本信息。
"""
import sys
import platform
print("=" * 50)
print("欢迎使用Python开发环境！")
print("=" * 50)
print(f"操作系统: {platform.system()} {platform.version()}")
print(f"Python版本: {sys.version}")
print(f"Python解释器位置: {sys.executable}")
print("=" * 50)
print("运行 'run_simple_test()' 进行环境测试。")
print("运行 'get_system_info()' 查看详细系统信息。")
print("运行 'get_pip_packages()' 查看已安装的包。")
print("=" * 50)
看到这个信息，就意味着你的Python开发环境已经成功搭建起来，随时可以开始探索代码的世界了。从检查版本到测试运行，每一步都是为了创造一个干净、可控的编程起点。现在，这个起点已经在你面前了。
实践应用
现在，我们动手搭建你的第一个Python开发环境。这个过程很直接，就像组装一套乐高积木，我们一步步来。
通常，我们得先确认电脑里是否装有Python，以及版本对不对。不用去命令行里敲打，我们可以直接用一个现成的工具来检查。比如，你想知道当前的Python版本是否高于3.6，可以这样做：
def check_python_version(min_version: tuple = (3, 6)) -> bool:
"""
检查当前Python版本是否满足最低要求版本。
参数:
min_version (tuple): 最低要求的Python版本，默认为(3, 6)。
返回:
bool: 如果当前Python版本满足或高于最低要求，返回True，否则返回False。
"""
import sys
# 获取当前Python版本
current_version = sys.version_info[:2]
# 比较版本
if current_version >= min_version:
print(f"Python版本检查通过: 当前版本 {'.'.join(map(str, current_version))} "
f">= 最低要求 {'.'.join(map(str, min_version))}")
return True
else:
print(f"Python版本检查失败: 当前版本 {'.'.join(map(str, current_version))} "
f"< 最低要求 {'.'.join(map(str, min_version))}")
return False
运行后，你会得到一个 True 或 False 的结果。如果返回 False，你就需要去Python官网下载并安装一个更新的版本了。
了解系统信息也很关键，不同的操作系统在后续步骤中可能会有细微差别。获取这些信息很简单：
def get_system_info() -> dict:
"""
获取当前系统的基本信息。
返回:
dict: 包含系统信息的字典，包括平台、Python版本等。
"""
import sys
import platform
system_info = {
"platform": platform.system(),
"platform_version": platform.version(),
"python_version": sys.version,
"python_version_info": {
"major": sys.version_info.major,
"minor": sys.version_info.minor,
"micro": sys.version_info.micro
},
"machine": platform.machine(),
"processor": platform.processor()
}
return system_info
它会返回一个字典，里面包含了你的操作系统类型、版本等详细信息，方便我们对照参考。
有了Python，接下来需要一个“工作间”——也就是虚拟环境。为什么需要它？想象一下，你同时做两个项目，一个需要旧版本的库A，另一个需要新版本的库A。如果没有隔离，它们就会冲突。虚拟环境就是为每个项目创建独立的包安装空间，互不干扰。创建一个名为 my_env 的虚拟环境，只需要：
def create_virtual_env(env_name: str = "venv") -> bool:
"""
在当前目录下创建Python虚拟环境。
参数:
env_name (str): 虚拟环境的名称，默认为"venv"。
返回:
bool: 创建成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查是否已存在同名虚拟环境
if os.path.exists(env_name):
print(f"虚拟环境 '{env_name}' 已存在。")
return False
try:
# 使用当前Python解释器创建虚拟环境
subprocess.run([sys.executable, "-m", "venv", env_name], check=True)
print(f"虚拟环境 '{env_name}' 创建成功。")
return True
except subprocess.CalledProcessError as e:
print(f"创建虚拟环境时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
这个命令会在你当前所在的文件夹里，生成一个叫 my_env（或者你指定的其他名字）的目录，里面就是全新的独立Python环境。
环境建好了，该往里安装项目需要的“零件”（第三方库）了。一个规范的项目通常会有一个 requirements.txt 文件，里面列明了所有依赖。安装它们只需：
def install_requirements(requirements_file: str = "requirements.txt") -> bool:
"""
使用pip安装requirements.txt文件中列出的依赖包。
参数:
requirements_file (str): requirements.txt文件的路径，默认为当前目录下的"requirements.txt"。
返回:
bool: 安装成功返回True，失败返回False。
"""
import subprocess
import sys
import os
# 检查requirements.txt文件是否存在
if not os.path.exists(requirements_file):
print(f"文件 '{requirements_file}' 不存在。")
return False
try:
# 使用pip安装依赖
subprocess.run([sys.executable, "-m", "pip", "install", "-r", requirements_file], check=True)
print(f"依赖包安装成功。")
return True
except subprocess.CalledProcessError as e:
print(f"安装依赖包时出错: {e}")
return False
except Exception as e:
print(f"未知错误: {e}")
return False
如果安装成功，函数会返回 True。之后，如果你想确认某个特定的包，比如 requests 是否真的装好了，可以：
def check_package_installed(package_name: str) -> bool:
"""
检查指定的Python包是否已安装。
参数:
package_name (str): 要检查的包名。
返回:
bool: 如果包已安装则返回True，否则返回False。
"""
import importlib.util
# 使用importlib检查包是否存在
spec = importlib.util.find_spec(package_name)
if spec is not None:
print(f"包 '{package_name}' 已安装。")
return True
else:
print(f"包 '{package_name}' 未安装。")
return False
想看看这个虚拟环境里已经安装了哪些包和它们的版本吗？运行这个：
def get_pip_packages() -> list:
"""
获取当前环境中通过pip安装的所有包及其版本。
返回:
list: 包含字典的列表，每个字典包含'name'和'version'键。
"""
import subprocess
import sys
try:
# 运行pip list命令获取包列表
result = subprocess.run([sys.executable, "-m", "pip", "list", "--format=freeze"],
capture_output=True, text=True, check=True)
packages = []
for line in result.stdout.strip().split('\n'):
if line:
# 每行格式为"package==version"
if '==' in line:
name, version = line.split('==')
packages.append({"name": name, "version": version})
return packages
except subprocess.CalledProcessError as e:
print(f"获取包列表时出错: {e}")
return []
except Exception as e:
print(f"未知错误: {e}")
return []
它会返回一个列表，清晰地展示所有已安装的包，这有助于管理和复现开发环境。
一切都设置妥当，最后我们来做个“点火测试”，确保所有环节运转正常。运行一个简单的测试脚本：
def run_simple_test() -> bool:
"""
运行一个简单的Python程序测试开发环境是否正常工作。
返回:
bool: 测试通过返回True，失败返回False。
"""
try:
# 简单的测试代码：计算并打印结果
result = 2 + 3 * 4
print(f"简单测试: 2 + 3 * 4 = {result}")
# 测试导入标准库
import math
print(f"数学库测试: π的近似值为 {math.pi}")
# 测试字符串操作
test_string = "Hello, Python!"
print(f"字符串测试: {test_string}")
print("开发环境测试通过！")
return True
except Exception as e:
print(f"开发环境测试失败: {e}")
return False
如果看到成功的提示，那么恭喜你！你的Python开发环境已经成功搭建并可以工作了。最后，让我们用一个欢迎信息来收尾，它汇总了当前环境的核心信息：
def print_welcome_message() -> None:
"""
打印欢迎信息，显示Python开发环境的基本信息。
"""
import sys
import platform
print("=" * 50)
print("欢迎使用Python开发环境！")
print("=" * 50)
print(f"操作系统: {platform.system()} {platform.version()}")
print(f"Python版本: {sys.version}")
print(f"Python解释器位置: {sys.executable}")
print("=" * 50)
print("运行 'run_simple_test()' 进行环境测试。")
print("运行 'get_system_info()' 查看详细系统信息。")
print("运行 'get_pip_packages()' 查看已安装的包。")
print("=" * 50)
搭建一个可用的Python开发环境并不复杂。从检查基础到创建独立空间，再到安装依赖和验证结果，每一步都有清晰的工具和目的。现在，这个环境已经准备好，等待你写下第一行代码了。
扫一扫
994
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
