在使用VSCode（Visual Studio Code）时，Code Runner插件为我们提供了方便快捷的代码运行体验。然而，当我们在运行包含相对路径的代码文件时，可能会遇到一些异常错误。这些问题主要源于当前工作目录（working directory）与相对路径之间的关系。
什么是相对路径？
相对路径是相对于当前工作目录的一种文件路径。在编程过程中，我们常常需要读取或写入文件，而相对路径可以简化代码的可移植性。然而，当我们使用Code Runner插件运行代码时，默认的工作目录可能不是我们期望的目录，这会导致相对路径无法正确解析，进而引发错误。
例子分析
假设我们有一个项目结构如下：
/project
│
├── main.py
└── data
└── sample.txt
main.py的代码如下：
# main.py
with open('data/sample.txt', 'r') as file:
content = file.read()
print(content)
在这个例子中，我们尝试读取位于data文件夹中的sample.txt文件。若我们在VSCode中直接运行main.py文件，可能会出现如下错误：
FileNotFoundError: [Errno 2] No such file or directory: 'data/sample.txt'
为什么会出现这个错误？
当我们使用Code Runner插件运行main.py时，Code Runner默认的工作目录可能不是/project，而是在VSCode的根目录或其他地方。这意味着，尽管我们在代码中使用了相对路径data/sample.txt，但程序并不在预期的目录中查找该文件，因此会导致文件未找到的错误。
如何解决？
解决这个问题的一个简单方法是使用绝对路径。我们可以通过Python的os模块来获取当前脚本的绝对路径，从而避免相对路径带来的问题。以下是修改后的代码示例：
import os
# 获取当前文件的绝对路径
current_dir = os.path.dirname(os.path.abspath(__file__))
file_path = os.path.join(current_dir, 'data', 'sample.txt')
with open(file_path, 'r') as file:
content = file.read()
print(content)
在这个代码中，我们首先获取了当前main.py文件的绝对路径，然后通过os.path.join构建了sample.txt的绝对路径。这样无论当前工作目录在哪里，我们都能正确找到目标文件。
配置VSCode Code Runner的工作目录
除了代码层面的调整，我们也可以通过配置Code Runner来确保它使用正确的工作目录。打开VSCode的设置，搜索Code-runner: Executor Map，可以找到不同语言的执行配置。对于Python，我们可以修改执行命令，以确保它在正确的目录下运行。
例如，可以将Python的执行命令设置为：
"python": "cd ${fileDirname} && python -u ${file}",
这里我们使用cd ${fileDirname}命令改变工作目录为当前文件的目录，然后再运行文件。这种方法可以确保所有相对路径都能被正确解析。
结论
在使用VSCode的Code Runner插件时，遇到相对路径导致的文件找不到问题，主要是因为工作目录的设置不当。通过使用绝对路径或调整Code Runner的工作目录配置，可以有效地避免这些问题。这样，不仅提高了代码的稳定性，也提高了开发效率。希望这篇文章能够帮助到你们在VSCode中更好地使用相对路径。
