在Python脚本开发中,指定文件位置是文件操作的基础步骤,无论是读取本地数据、写入生成结果还是调用配置文件,都需要先准确定位到目标文件的存储位置,否则会直接触发文件不存在的异常。

文件路径的两种常见形式
绝对路径
绝对路径是从系统根目录开始到目标文件的完整路径,不同操作系统的绝对路径格式有所区别。Windows系统的绝对路径通常以盘符开头,比如C:Userstestdata.txt;Linux和macOS系统的绝对路径以斜杠开头,比如/home/user/data.txt。
使用绝对路径的优势是定位准确,只要文件没有被移动,脚本在任何目录下运行都能找到目标文件。缺点是路径和具体系统绑定,换一台设备运行就需要修改路径,灵活性较差。
相对路径
相对路径是相对于当前Python脚本运行目录的路径,不需要写完整的根目录信息。比如脚本和要操作的文件在同一个文件夹下,直接写文件名data.txt就可以定位到文件;如果文件在脚本所在目录的子文件夹里,可以写成subdir/data.txt。
相对路径的优势是跨设备兼容性好,只要保持脚本和文件的相对位置不变,换系统也不需要修改路径。缺点是需要明确脚本的运行目录,否则容易出现路径匹配错误。
Python中指定文件并操作的基础方法
Python内置的open()函数是操作文件的核心,第一个参数就是需要指定的文件路径,第二个参数是操作模式。下面是读取文件的基础示例:
# 指定相对路径读取文件,文件在当前脚本同目录下
file_path = "test.txt"
# 以只读模式打开文件,指定编码为utf-8避免中文乱码
try:
f = open(file_path, "r", encoding="utf-8")
content = f.read()
print("文件内容:", content)
f.close()
except FileNotFoundError:
print("指定的文件不存在,请检查路径是否正确")
如果要使用绝对路径,只需要把file_path的值换成完整的绝对路径即可,比如Windows下可以写成file_path = r"C:Userstesttest.txt",注意字符串前的r是为了避免反斜杠被识别为转义字符。
跨平台路径拼接的规范方式
不同系统的路径分隔符不同,直接手写路径容易出现兼容性问题,推荐使用os.path模块或者pathlib模块来拼接路径,自动适配当前系统的分隔符。
使用os.path模块拼接路径
import os
# 拼接绝对路径,第一个参数是基础目录,后面是各级子目录和文件名
base_dir = "C:\Users\test"
file_name = "data.txt"
full_path = os.path.join(base_dir, file_name)
print("拼接后的路径:", full_path)
# 拼接相对路径,获取当前脚本所在目录,再拼接子目录文件
script_dir = os.path.dirname(os.path.abspath(__file__))
target_file = os.path.join(script_dir, "config", "setting.ini")
print("目标文件路径:", target_file)
使用pathlib模块拼接路径
pathlib是Python3.4+引入的面向对象的路径处理模块,使用起来更加简洁:
from pathlib import Path
# 创建路径对象,拼接子路径
base_path = Path("C:/Users/test")
full_path = base_path / "data.txt"
print("拼接后的路径:", full_path)
# 获取当前脚本目录,拼接目标文件
script_path = Path(__file__).parent
target_file = script_path / "logs" / "run.log"
print("目标日志文件路径:", target_file)
# 直接用路径对象打开文件
with open(target_file, "a", encoding="utf-8") as f:
f.write("新的日志内容n")
常见路径指定错误及解决方法
- 文件路径包含中文或特殊字符:尽量保证路径和文件名使用英文,若必须包含中文,打开文件时指定
encoding="utf-8"参数。 - 相对路径找不到文件:可以在脚本中打印当前运行目录确认位置,使用
print(os.getcwd())查看当前工作目录,再调整相对路径的写法。 - 反斜杠转义问题:Windows路径中的反斜杠要么写成双反斜杠
\,要么在字符串前加r使用原始字符串,要么直接用正斜杠/,Python会自动适配系统。
不同操作模式的路径指定注意事项
使用open()函数时,如果操作模式是写入w或者追加a,如果指定的文件不存在,Python会自动创建该文件,但前提是文件所在的目录必须已经存在。如果目录不存在,会抛出FileNotFoundError异常,此时需要先创建目录:
import os
from pathlib import Path
file_path = Path("new_dir/test.txt")
# 如果文件所在目录不存在,先创建目录,exist_ok=True表示目录存在时不报错
file_path.parent.mkdir(parents=True, exist_ok=True)
# 写入文件
with open(file_path, "w", encoding="utf-8") as f:
f.write("这是新创建的文件内容")