解决VSCode无法识别相对路径的问题

前言:

近日在学习python文件操作时,发现使用VSCode作为编辑器时,文件的相对路径会出问题,报错"指定路径下找不到文件",无法找到想要的文件。

知识点①:不同操作系统所使用的路径斜杠不同:Linux系统是/,Windows系统是\

知识点②:在使用相对路径表示【某源代码文件】所在的位置时,使用 ./ 表示当前所在目录,使用 ../ 表示当前所在目录的父目录。

问题:

这里先贴上笔者使用相对路径的 Python 代码段:

python 复制代码
# 该代码片段位于 draw_chart.py 文件中
chart_title = '1836A'
file_path = f"../pending_files/{chart_title}.xlsx"   # 欲使用相对路径引用 1836A.xlsx 文件

再列出笔者的工程目录树

Python_project

└─ .vscode

│ ├─ launch.json

│ └─ settings.json

├─ app_sample

│ └─ draw_chart.py

├─ pending_files

│ └─ 1836A.xlsx

在基于以上的情况下,出现了相对路径报错的问题。报错提示如下图所示:

🌵 解决方案(一)

修改要点 :将相对路径引用的代码段修改成当前目录引用,即../改成./,如下所示。

python 复制代码
# 该代码片段位于 draw_chart.py 文件中
chart_title = '1836A'
file_path = f"./pending_files/{chart_title}.xlsx"   # 欲使用相对路径引用 1836A.xlsx 文件

修改后可正常运行,问题解决。

修改原理 :因为此时相对路径的【参照位置】,是打开的"工程项目文件夹",不是源代码文件目录所在位置。

以笔者的工程项目Python_project为示例,此时相对路径的【参照位置】是当前目录Python_project文件夹,不是app_sample!!!

则相对路径"./pending_files/{chart_title}.xlsx"等价于

绝对路径"E:/code/Python_project/pending_files/1836A.xlsx"。

🌵 解决方案(二)

修改要点1 :首先我们不修改相对路径的引用,即代码段保持../不变。

python 复制代码
# 该代码片段位于 draw_chart.py 文件中
chart_title = '1836A'
file_path = f"../pending_files/{chart_title}.xlsx"   # 欲使用相对路径引用 1836A.xlsx 文件

修改要点2 :其次使用UI形式设置,依次打开 设置→搜索execute→勾选 Execute in file Dir 选项,如下图所示:

或者使用json文本形式设置,即在settings.json中添加"python.terminal.executeInFileDir": true,,如下图所示:

上述两者效果是一致的,VSCode有UI和json文本两种形式设置,任选一种即可,笔者推荐json文本形式设置。

最后运行Python代码,可以看到正常运行,问题解决。

修改原理 :此时相对路径的【参照位置】,是"当前源代码的文件目录"。

以笔者的工程项目Python_project为示例,此时相对路径的【参照位置】是app_sample

则相对路径".../pending_files/{chart_title}.xlsx"等价于

绝对路径"E:/code/Python_project/pending_files/1836A.xlsx"。

📚参考链接

VScode - 相对路径

[报错] VSCODE无法识别相对路径

绝对路径和相对路径区别详解

什么是相对路径?相对路径的具体写法和用法

Python绝对路径和相对路径详解

相关推荐
CAE虚拟与现实7 小时前
VSCode中的下载VSIX是指什么?
ide·vscode·编辑器
路边闲人210 小时前
vscode启用GEMINI CODE ASSIST插件
ide·vscode·gemini
小蕾Java10 小时前
Java 开发工具,最新2025 IDEA使用(附详细教程)
java·ide·intellij-idea
CAE虚拟与现实10 小时前
VSCode官方汉化包
ide·vscode·编辑器·vscode汉化
CAE虚拟与现实10 小时前
VSCode创建Python项目和运行py文件
ide·vscode·编辑器
资讯第一线10 小时前
《RAD Studio 13.0》 [DELPHI 13.0] [官方原版IOS] 下载
ide
过-眼-云-烟12 小时前
新版Android Studio能打包但无法run ‘app‘,编译通过后手机中没有安装,顶部一直转圈
android·ide·android studio
Stardep12 小时前
ssh远程连接服务器到vscode上“连接失败”
服务器·vscode·ssh
扯淡的闲人17 小时前
多语言编码Agent解决方案(4)-Eclipse插件实现
java·ide·eclipse
患得患失94920 小时前
【前端】【高德地图WebJs】【知识体系搭建】面要素知识点——>多边形,圆形, 矩形,图形编辑器
前端·编辑器·高德地图·amap