文件路径入门：绝对路径、相对路径与跨平台常见陷阱
“文件明明在那里，程序却说找不到”是很常见的问题。原因未必是文件丢了，也可能是程序从另一个目录开始寻找，路径里的空格被命令行拆开，或者本机可以混用的大小写到了服务器上不再等价。
理解路径时，先记住一个问题：这串文字是相对于哪里解释的？本文用虚构目录说明规则，示例以查看和打印为主，不执行删除或批量移动操作。路径请按自己的环境替换，示例结果也不代表任何机器上的真实文件已经存在。
一、路径是地址，不是文件本身
文件路径描述如何定位文件系统中的一个对象。比如 /home/lin/project/readme.md，包含根目录、逐层目录和最后的文件名。扩展名通常帮助人识别用途，但它并不保证内部内容符合相应格式。
同一个对象可能有多个访问入口，例如符号链接；同一串路径也可能在不同电脑上指向完全不同的内容。因而，把自己的绝对路径发给同事，并不会把文件同时发送过去。
“路径写得对”“路径存在”“当前用户有权限”“内容符合预期”是四个不同条件。排错时应逐项确认，不能因为文件管理器能看到它，就认定所有程序都能读取它。
二、绝对路径与相对路径的差别
绝对路径从明确的起点出发。Linux 和 macOS 中，典型形式是 /Users/lin/Documents/report.txt 或 /home/lin/report.txt；Windows 中则常见 C:\Users\Lin\Documents\report.txt。
相对路径需要一个上下文。在普通命令行和许多程序文件操作中，这个上下文是当前工作目录。例如，假设当前目录为 /home/lin/project：
data/input.csv指向项目下的 data 目录。./data/input.csv明确从当前目录出发，通常与上一项等价。../input.csv先退到上一级，再寻找 input.csv。
. 表示当前目录，.. 表示上一级。这里的示例按普通目录解释；涉及符号链接时，不能只靠肉眼删去某个目录名和后面的 .. 来认定最终目标。
最容易误解的是：相对路径不一定相对于脚本文件所在目录。你在不同位置启动同一份脚本，当前工作目录可能不同；编辑器的运行按钮、终端、定时任务也可能提供不同起点。某些应用另有“相对于配置文件”的规则，因此应以该应用文档为准。
三、先确认自己站在哪里
在 Linux 或 macOS 的终端中，可以运行：
pwd
ls -ld './data'
第一条显示当前目录，第二条检查当前目录下名为 data 的项目。若 data 不存在，报错是有用线索，不应马上改成管理员权限。
在 PowerShell 中，对应的检查方式是：
Get-Location
Test-Path -LiteralPath '.\data'
Get-Item -LiteralPath '.\data'
先确认当前位置，再逐层检查目录，可以避免在一个错误起点上反复修改末尾文件名。排错记录中最好同时写明使用的终端类型；PowerShell、传统 cmd 和 Bash 的语法并不完全相同。
四、Windows 盘符后少一个斜杠，含义就变了
C:\work\note.txt 是从 C 盘根目录出发的路径，而 C:work\note.txt 是相对于 C 盘当前目录的路径。两者不能互换。以 \work\note.txt 开头但不指定盘符时，也依赖当前驱动器，不是你可能以为的固定 C 盘地址。微软在Windows 路径格式文档中特别说明了这些区别。
网络共享还会出现 \\server\share\folder\file.txt 这样的 UNC 路径。它依赖服务器、共享名、网络可达性和访问权限，不是把开头改成某个盘符就能等价转换。
此外，不要把网页 URL 和本地路径混为一谈。URL 中的百分号编码、查询参数、斜杠与本地文件名规则不是一套语法。从浏览器复制链接后，不能简单粘贴进本地文件读取函数并期待它自动下载。
五、空格不是问题，没正确引用才是问题
在 Bash 中，包含空格的路径应作为一个完整参数传给命令：
ls -ld "$HOME/My Documents"
双引号保留路径中的空格，同时允许 $HOME 展开。相反，单引号中的 '$HOME/My Documents' 通常会把 $HOME 当成普通文字。
~ 也不是所有程序都理解的“主目录代码”。在 Bash 中，未加引号且处于适当位置的 ~ 会由 shell 展开，而写成 "~/My Documents" 时不会按同样方式展开。因此，示例使用 "$HOME/My Documents"。规则可核对 Bash 引号说明与波浪号展开说明。
PowerShell 中可以使用字面路径参数减少特殊字符带来的歧义：
Get-Item -LiteralPath 'C:\Users\Lin\My Documents'
不要把一套 shell 的转义方式直接复制到另一套 shell。遇到带空格、方括号或引号的文件名，先用只读查看命令验证参数解释，再执行复制或其他修改操作。
六、跨平台时，大小写和文件名都要保守处理
Linux 常见文件系统上的文件名通常区分大小写，Logo.png 与 logo.png 可以是两个对象。Windows 的常见配置往往不区分大小写，但仍存在特殊配置，不能写成毫无例外的操作系统定律。
macOS 也不能简单归入“永远区分”或“永远不区分”。Apple 提供普通 APFS 和区分大小写的 APFS 格式，同一台机器不同卷的行为可以不同，详见磁盘工具的文件系统格式说明。
跨平台项目的实用做法是：文件名和引用中的大小写始终一致，不创建仅大小写不同的两个文件。图片链接在本机正常、部署后失效时，应优先核对这一点。
Windows 还存在保留字符和设备名称等限制，例如不要把普通文件命名为 CON 或 NUL，也不要依赖结尾空格或句点。具体范围应查微软文件命名规则。用于跨系统交换的资料，采用简短明确的名字、适度目录层级，并避免特殊字符组合，通常能减少迁移摩擦。中文文件名本身不等于错误，但整个传输和工具链必须正确处理编码。
七、写程序时让路径库负责拼接
手工把目录、斜杠和文件名相加，很容易漏掉分隔符，或写出只适用于一台机器的路径。Python 可以使用 pathlib：
from pathlib import Path
base = Path.cwd()
source = base / "data" / "input.csv"
print("当前目录：", base)
print("目标路径：", source)
print("是否存在：", source.exists())
它只打印信息，不创建或修改文件。如果代码明确要求资源相对于脚本位置，可以在普通脚本环境中考虑 Path(__file__).resolve().parent，但交互环境不一定提供 __file__，打包程序也可能有自己的资源加载机制。
路径库不是安全边界。把来自外部输入的绝对路径拼到基础目录后面，可能丢弃前面的基础部分；.. 和符号链接也可能影响实际目标。处理用户上传或解压文件时，需要专门校验最终访问范围，不能只靠字符串前缀判断。Python pathlib 官方文档说明了路径拼接、纯路径和实际文件系统路径的区别。
八、一套可重复的排错顺序
下次再遇到“找不到文件”，先打印当前目录与最终路径，再检查盘符、目录层级和大小写，然后确认空格是否被完整引用。接着检查对象是否存在、是否为预期的文件类型，以及当前进程是否具有权限。
若涉及网络盘、外接盘或容器，还要确认挂载位置和运行环境。程序能读取宿主机上的哪个目录，取决于实际配置，而不是宿主机文件管理器显示了什么。
最后再考虑路径长度、特殊字符、编码与链接。不要把“换成绝对路径后能运行”直接当作所有问题的最终答案：绝对路径适合明确位置，相对路径适合可迁移的项目结构。真正可靠的方案，是清楚定义起点、使用一致的文件命名规则，并在执行重要操作前确认最终目标。