讲师中心 微信公众号
AI工具推荐 视频效率加速

为什么Python脚本在Linux环境下运行报FileNotFoundError?

陌晨君_3768

陌晨君_3768

发布时间:2026-07-11 09:49:37

|

980人浏览过

|

来源于php中文网

原创

Linux下FileNotFoundError而Windows正常,根本原因是路径解析逻辑差异:Linux大小写敏感、不自动处理软链接,Windows则容错性强;os.getcwd()返回启动目录而非脚本目录,相对路径易错;应统一用pathlib.Path(__file__).parent.resolve()构造路径。

为什么python脚本在linux环境下运行报filenotfounderror?

FileNotFoundError 在 Linux 下出现、Windows 下却正常,根本不是 Python 版本或语法的问题,而是路径解析逻辑和运行时环境的差异被直接暴露了。

Linux 严格按字面匹配路径,大小写敏感,不自动处理软链接跳转,也不容忍拼写容错;Windows 则会帮你“猜”——接受 \ 和 / 混用、忽略大小写、甚至补全空格。同一行代码,在两个系统上走的是完全不同的路径查找路径。


为什么 os.getcwd() 不可靠?

它返回的是你「启动脚本时所在的终端目录」,不是脚本文件所在目录。

比如你在 /home/user 目录下执行:
python /home/user/project/main.py
那么 os.getcwd() 就是 /home/user,不是 /home/user/project。

立即学习“Python免费学习笔记(深入)”;

Python Packaging
Python Packaging

深度Python打包工作流——pyproject元数据、依赖与可选额外项、构建后端、wheel、版本控制、发布及CI发布规范……

下载
  • 相对路径如 "data/config.json" 会被拼到 /home/user/data/config.json,而不是你期望的 /home/user/project/data/config.json
  • VS Code 在 Windows 上点「运行」默认把 CWD 切到脚本目录,但 Linux 终端不会——这是 IDE 行为差异,不是 Python 问题
  • 用 os.chdir() 强制切换工作目录容易引发副作用(比如后续 open() 调用依赖原始 CWD)

为什么直接拼 __file__ 路径会出错?

__file__ 是脚本的路径字符串,但它可能带符号链接、相对路径段(如 ../),也可能没展开成绝对路径。

错误写法:
os.path.dirname(__file__) + "/../data/file.txt"
这个字符串拼接在 Linux 下不会自动规范化,.. 不会被解析,最终路径可能是无效的。

  • os.path.dirname(__file__) 返回的是原始路径,可能含 ./ 或符号链接目标路径,不是你脚本实际所在位置
  • 必须配合 os.path.abspath() 或 pathlib.Path(__file__).parent 才能得到真实父目录
  • 推荐统一用 pathlib.Path(__file__).parent / "data" / "config.json",/ 运算符自动处理分隔符和层级跳转

硬编码 Windows 路径在 Linux 上必然崩溃

像 "C:\Users\me\input.csv" 这种写法复制到 Linux 后:

  • C: 驱动器根本不存在
  • \U 被解释为 Unicode 转义序列,导致字符串提前截断或解析失败
  • 即使改成 "C:/Users/me/input.csv",Linux 依然找不到 C:
  • 中文、空格、括号(如 "(2024) report.xlsx")在 shell 参数传递时可能被分割或编码错乱,报的仍是 FileNotFoundError,但真实原因是路径被截断

怎么验证路径到底对不对?

别靠“看起来像对”,要用操作系统级命令确认。

  • 先查当前工作目录:import os; print(os.getcwd())
  • 再查脚本真实位置:from pathlib import Path; print(Path(__file__).resolve().parent)
  • 最后用 Path("your_path").exists() 或 os.path.exists("your_path") 实际检查路径是否存在
  • 如果路径含中文或特殊字符,临时改用纯英文命名测试,排除编码/Shell 解析干扰

真正麻烦的从来不是“文件在哪”,而是“Python 认为你该去哪找”。跨平台脚本里,所有路径构造都得基于 <strong>file</strong> 动态生成,且必须 resolve 到真实路径——这点在 Linux 上无法妥协。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1631

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

3944

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1629

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

22717

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2787

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2827

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1123

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python venv官方模块文档
Python venv官方模块文档

共0课时 | 0人学习

python开发单词查询系统
python开发单词查询系统

共8课时 | 2.4万人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn