文章目录
- 开篇：告别路径混乱，用 os 模块高效管理你的文件
- 1.2 为什么函数名是 `getcwd`，而不是更直白的 `get_current_folder`？
开篇：告别路径混乱，用 os 模块高效管理你的文件
你是否曾在 Python 项目中为文件路径拼接、目录遍历或环境变量读取而头疼？手动拼接字符串容易出错，跨平台兼容性更是噩梦。本文将带你系统掌握 Python 标准库 os 模块，从获取当前路径到执行系统命令，彻底解决文件与路径管理的痛点。读完本文，你将能写出健壮、跨平台的路径处理代码，并理解其背后的操作系统原理，轻松应对日常开发中的文件操作需求。
1. 初识 os 模块：导入与基础概念
学习任何库的第一步都是导入。对于 os 模块，导入方式非常简单：
import os # 导入 os 模块，这是所有后续操作的基础
导入后，我们就可以使用 os 模块提供的各种函数来与操作系统交互。在深入具体功能前，我们先理解一个核心概念：当前工作目录（Current Working Directory, cwd）。
1.1 cwd 到底是什么？
在操作系统中，每个进程（比如你运行的 Python 程序）都有一个属性叫做“当前工作目录”。它决定了：
- 当你使用相对路径（例如
./data/file.txt）访问文件时，系统会从这个目录开始查找。 - 许多命令行工具和程序在运行时，都依赖这个目录作为默认的起点。
os.getcwd() 函数的作用，就是把这个目录的绝对路径以字符串形式返回给你。
1.2 为什么函数名是 getcwd，而不是更直白的 get_current_folder？
很多人以为 Python 的命名不够“人性化”，但其实这背后是历史与标准的传承。核心原因就两个字：历史与标准。
Python 的 os 模块在底层封装了 C 语言的标准库（POSIX 标准）函数。在 C 语言中，获取当前工作目录的函数就是：
char *getcwd(char *buf, size_t size);
Python 为了保持语义清晰和跨平台一致性，直接沿用了这个名字，变成了 os.getcwd()。类似的，改变当前工作目录的函数叫 os.chdir()，对应的就是 C 语言的 chdir()。
所以你可以这样记忆：
- cwd = Current Working Directory
- getcwd = get current working directory
简单直接，全世界写操作系统和 C 程序的人都这么叫，Python 也就没必要发明新词了。
2. 核心操作一：获取与理解当前路径
理解了概念，我们来看具体代码。
2.1 获取当前工作路径
# 如何获取当前的路径nowCwd = os.getcwd() # 注意：getcwd 是一个函数，需要加括号调用print(f"当前的工作路径为：{nowCwd}")
输出示例：
当前的工作路径为：d:\python_code_test
关键行注释：
os.getcwd(): 调用函数，返回当前 Python 脚本所在目录的绝对路径字符串。- 输出显示的是文件夹路径，而不是你当前正在编辑的
.ipynb 或 .py 文件本身。
2.2 路径拼接：组合文件夹与文件名
只拿到文件夹路径往往不够，我们经常需要得到某个特定文件的完整路径。这时就需要路径拼接。
# 将文件夹路径与文件名进行拼接res_cwd = os.path.join(nowCwd, "learm_os.ipynb") # 使用 os.path.join 进行拼接print(f"拼接之后的完整路径为：{res_cwd}")
输出示例：
拼接之后的完整路径为：d:\python_code_test\learm_os.ipynb
为什么用 os.path.join 而不是字符串相加？os.path.join() 方法能自动识别当前操作系统（Windows 用 \，Linux/macOS 用 /），并正确处理路径分隔符，避免因手动拼接导致的跨平台兼容性问题。这是编写健壮代码的关键。
2.3 路径拆分：分离目录与文件名
有合就有分。有时我们需要从一个完整路径中提取目录部分或文件名部分。
# 对一个完整路径进行拆分dirN = os.path.dirname(res_cwd) # 获取路径的目录部分baseN = os.path.basename(res_cwd) # 获取路径的文件名部分print(f"目录部分：{dirN}")print(f"文件名部分：{baseN}")
输出示例：
目录部分：d:\python_code_test文件名部分：learm_os.ipynb
3. 核心操作二：路径检查与文件属性
操作文件前，先检查其是否存在和类型，是好习惯。
3.1 检查路径是否存在
# 先定义一个测试路径（注意：这是一个不存在的路径示例）testCWD = "c/user/app" # 这是一个错误的 Windows 路径格式# 判断路径是否存在if os.path.exists(testCWD): print(f"路径 '{testCWD}' 存在")else: print(f"路径 '{testCWD}' 不存在")
输出示例：
我实际遇到的踩坑：在 Windows 上，我曾错误地使用了 "/Program Files (x86)/Tencent" 这样的路径，结果 os.path.exists 一直返回 False。原因在于它缺少了盘符（如 C:），在 Windows 上不被识别为有效绝对路径。正确的完整路径应类似 "C:/Program Files (x86)/Tencent" 或 r"C:\Program Files (x86)\Tencent"。
3.2 区分路径与文件
os.path.exists 只告诉是否存在，os.path.isfile 和 os.path.isdir 则能区分是文件还是目录。
test_path = r"D:\python_code_test\learm_os.ipynb" # 假设这是一个真实存在的文件# 判断是否为文件if os.path.isfile(test_path): print(f"'{test_path}' 是一个文件")else: print(f"'{test_path}' 不是一个文件")# 判断是否为目录（文件夹）if os.path.isdir(test_path): print(f"'{test_path}' 是一个目录")else: print(f"'{test_path}' 不是一个目录")
输出示例：
'D:\python_code_test\learm_os.ipynb' 是一个文件'D:\python_code_test\learm_os.ipynb' 不是一个目录
3.3 获取文件大小
在文件上传、磁盘空间检查等场景中，获取文件大小是常见需求。
# 获取一个文件的大小（单位：字节）file_size = os.path.getsize("learm_os.ipynb") # 传入文件名（需在当前目录或使用完整路径）print(f"文件 'learm_os.ipynb' 的大小为：{file_size} 字节")# 可以转换为更易读的单位print(f"约合：{file_size / 1024:.2f} KB")
输出示例：
文件 'learm_os.ipynb' 的大小为：1880 字节约合：1.84 KB
[📷建议：一张示意图，展示 os.path 系列函数（exists, isfile, isdir, getsize）在处理一个文件路径时的逻辑判断流程]
4. 核心操作三：目录的增删改查
掌握了文件，我们来管理目录。
4.1 创建目录
创建目录有非递归和递归两种方式。
# 1. 非递归创建目录（只能创建一级）new_dir = "testMakeDir_1"try: os.mkdir(new_dir) # mkdir 即 make directory print(f"目录 '{new_dir}' 创建成功")except FileExistsError: print(f"目录 '{new_dir}' 已存在，创建失败")# 2. 递归创建目录（可以创建多级）deep_dir = "parent/child/grandchild"os.makedirs(deep_dir, exist_ok=True) # exist_ok=True 表示如果目录已存在则不报错print(f"递归目录结构 '{deep_dir}' 已创建或已存在")
关键行注释：
os.mkdir()os.makedirs(): 创建多级目录，exist_ok=True 参数能避免因目录已存在而导致的程序中断，是更安全的做法。
4.2 删除目录
同样，删除也分非递归和递归。
# 1. 删除空目录（非递归）try: os.rmdir("testMakeDir_1") # rmdir 即 remove directory print("目录删除成功")except OSError as e: print(f"删除失败：{e}")# 2. 递归删除空目录# os.removedirs("parent/child/grandchild") # 会从最内层空目录开始删除，直到遇到非空目录为止# 注意：removedirs 要求每级目录都是空的，否则会失败。
推断性建议：在实际项目中，更推荐使用 shutil.rmtree() 来删除非空目录，因为 os.rmdir 和 os.removedirs 都只能删除空目录，局限性较大。
4.3 遍历目录内容
列出目录下的文件和子目录。
# 1. 非递归列出当前目录下的所有条目list_dir = os.listdir(".") # “.” 代表当前目录print(f"当前目录下的所有文件和文件夹：{list_dir}")# 2. 递归遍历目录树（使用生成器，节省内存）for root, dirs, files in os.walk("."): print(f"当前根目录：{root}") print(f" 子目录列表：{dirs}") print(f" 文件列表：{files}") print("-" * 30)
输出示例（片段）：
当前目录下的所有文件和文件夹：['.git', '.vscode', 'learm_os.ipynb', ...]当前根目录：. 子目录列表：['.git', '.vscode', '__pycache__'] 文件列表：['learm_os.ipynb', 'test.txt', ...]------------------------------
关于 os.walk 返回生成器的深度解释：os.walk() 返回的是一个生成器（Generator），而不是一个立即包含所有结果的列表。这是因为目录可能非常大，一次性加载所有结果会消耗大量内存。生成器采用“惰性求值”，只在需要时（比如在 for 循环的每次迭代中）产生下一组 (root, dirs, files) 数据，极大地提升了处理大目录时的效率。
5. 高级应用：环境变量与系统信息
os 模块还能让你与程序运行的环境交互。
5.1 获取与设置环境变量
环境变量是操作系统或用户设置的一些全局配置。
# 1. 获取所有环境变量（返回一个类似字典的对象）all_envs = os.environprint("所有环境变量（数量很多，通常取特定值）")# 2. 获取特定的环境变量，例如系统 PATHpath_value = os.environ.get("PATH")print(f"PATH 环境变量的类型：{type(path_value)}")if path_value: # PATH 在 Windows 上以分号分隔，在 Linux/macOS 上以冒号分隔 path_list = path_value.split(";") # Windows 分隔符 print("PATH 中的前几个路径：") for p in path_list[:3]: # 只打印前三个，避免输出过长 print(f" - {p}")# 3. 临时设置环境变量（仅对当前进程及其子进程有效）os.environ["MY_CUSTOM_VAR"] = "Hello_OS_Module"print(f"自定义环境变量值：{os.environ.get('MY_CUSTOM_VAR')}")
5.2 获取系统名称
# 获取当前操作系统的名称system_name = os.nameprint(f"当前操作系统标识：{system_name}")
输出与解释：
- 在 Linux/Unix 上会输出
'posix'。
5.3 执行系统命令
os.system() 允许你运行操作系统的 shell 命令。
# 执行一条系统命令（例如，在 Windows 上列出目录）return_code = os.system("dir") # Windows 命令# 在 Linux/macOS 上应使用 os.system("ls")print(f"\n命令执行完毕，返回码：{return_code}")
注意：os.system() 会启动一个新的 shell 进程来执行命令，并将命令的输出直接打印到控制台。它的返回值是命令的退出状态码（通常 0 表示成功）。
[📷建议：一张表格，对比 os 模块中常用函数的功能、参数和返回值，如 getcwd, listdir, walk, system 等]
总结与思考
通过本文，我们系统性地掌握了 Python os 模块的核心功能：
- 路径基础：理解了
cwd 的概念与 getcwd() 的历史渊源，学会了使用 join, dirname, basename 进行路径的拼接与拆分。 - 路径检查：掌握了用
exists, isfile, isdir 检查路径状态，用 getsize 获取文件大小，这是文件操作前的安全步骤。 - 目录管理：学会了用
mkdir/makedirs 创建目录，用 rmdir 删除目录，以及用 listdir 和 walk 遍历目录内容，并理解了 walk 生成器的高效原理。 - 系统交互：了解了如何通过
environ 读写环境变量，用 name 判断操作系统，并用 system 执行 shell 命令。
核心收获：os 模块是 Python 与操作系统交互的桥梁，其设计遵循了底层系统标准（如 POSIX），保证了跨平台能力。关键在于理解路径的抽象与操作系统的差异，并善用 os.path 子模块来处理这些差异。
你在使用 os 模块进行文件操作时，还遇到过哪些意想不到的“坑”或有趣的用例？欢迎在评论区分享你的经验！
