PyCharm如何解决找不到脚本路径的问题

星枫君_5496

星枫君_5496

2026-08-13

261人浏览

原创

pycharm报“找不到文件”或“modulenotfounderror”主因是工作目录未正确配置或python解释器指向错误环境;默认以脚本所在目录为工作目录,导致相对路径解析失败,需在run/debug configurations中手动设为项目根目录并匹配解释器路径。

pycharm如何解决找不到脚本路径的问题

PyCharm 运行脚本时提示“找不到文件”或“ModuleNotFoundError”,绝大多数情况不是代码写错了,而是工作目录(Working Directory)没设对,或者 Python 解释器路径本身指向了错误环境。

为什么 PyCharm 会找不到相对路径的文件?

PyCharm 默认把“当前脚本所在目录”当作工作目录。比如你在 tools/train.py 点右键运行,工作目录就是 tools/,而不是项目根目录。这时代码里写的 ./configs/yolox_s.yaml 就会去 tools/configs/ 下找,自然报 FileNotFoundError。

  • 工作目录 ≠ 脚本所在目录,也不等于项目根目录,它完全可配
  • __file__ 返回的是脚本路径,但 open("data.txt") 的查找起点是工作目录,不是 __file__ 所在位置
  • Linux 终端或命令行直接运行时,工作目录是你执行 python xxx.py 时所在的目录;PyCharm 默认不继承这个行为

怎么改工作目录?

在运行/调试配置里手动指定,这是最直接有效的解法。

PyCharm 2026.2
PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。

下载
  • 点击右上角运行配置名称 → Edit Configurations…
  • 找到 Working directory 字段
  • 填入项目根路径,例如:/home/user/YOLOX_PROJECT 或 C:\work\YOLOX_PROJECT
  • 勾选 Add content root to PYTHONPATH 和 Add source roots to PYTHONPATH(避免包导入失败)
  • 保存后重新运行,所有 ./configs/、../datasets/ 都能正确解析了

为什么终端里 pip install 了却 still ModuleNotFoundError?

常见于 Windows + PowerShell 终端场景:PowerShell 执行策略(ExecutionPolicy)默认为 Restricted,会静默阻止 conda activate 或虚拟环境激活脚本运行,导致终端看似激活了环境,实际 PYTHONPATH 和 PATH 并未更新。

  • 在 PyCharm 终端中执行:Get-ExecutionPolicy,如果返回 Restricted,就确认是这个问题
  • 临时修复:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 更稳妥的做法:在 PyCharm 设置中把终端 Shell path 改成 cmd.exe 或 bash(Linux/macOS),绕过 PowerShell 限制
  • 验证是否生效:运行 python -c "import sys; print(sys.executable)",输出路径必须和你在 Project Interpreter 里配置的一致

脚本里动态加路径靠谱吗?

用 os.path.abspath(__file__) 推导根目录再塞进 sys.path,适合部署到服务器或 CI 环境,但在 PyCharm 里属于“补救手段”,不该是首选。

  • 示例写法:sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
  • 问题在于:每次 import 都要重复这段逻辑;多人协作时容易漏写;且无法解决配置文件、数据集等非 Python 文件的路径问题
  • 真正该优先做的,是统一配置好 Working directory 和 Python Interpreter,让环境行为和预期一致
  • 只在必须支持多入口点(如不同子目录下都有 main.py)时,才考虑封装路径推导逻辑

工作目录和解释器路径这两个配置项,看着不起眼,但一旦出错,表现出来的症状五花八门——文件找不到、模块找不到、甚至某些库初始化失败。调的时候别急着改代码,先看这两处设置是否真实匹配你的项目结构。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

2023.07.25

2529

3

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

2023.08.21

4717

4

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.04

738

5

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

754

5

python和pycharm的区别
python和pycharm的区别

Python和PyCharm是两个不同的概念,它们的区别如下:1、Python是一种编程语言,而PyCharm是一款Python集成开发环境;2、Python可以运行在各种不同的开发环境中,而PyCharm是专门为Python开发而设计的IDE等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

487

5

pycharm环境如何配置
pycharm环境如何配置

配置教程:1、下载并安装PyCharm;2、选择Python解释器;3、配置虚拟环境;4、配置代码风格;5、配置调试器;6、配置版本控制工具;7、配置插件;8、配置Python路径和环境变量;9、配置其他选项。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

502

5

pycharm解释器如何安装
pycharm解释器如何安装

安装步骤:1、打开PyCharm并打开你的项目;2、转到"File">“Settings”;3、在设置窗口中选择"Project">“Python Interpreter”;4、 点击“+” 符号添加新的解释器等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

323

5

pycharm并行运行是啥意思
pycharm并行运行是啥意思

pycharm中的并行运行功能允许并发运行代码块,提高开发和测试效率。通过启用该功能和设置进程数,可以:加快开发和调试过程;缩短测试套件的运行时间;充分利用多核处理器;简化复杂代码的结构和维护。想了解更多pycharm的相关内容,可以阅读本专题下面的文章。

2024.04.18

1168

11

pycharm的作用
pycharm的作用

pycharm是一款专为python编程设计的ide,提供以下功能:智能代码补全,实时错误检测和快速修复;代码重构,版本控制集成,先进调试工具等等。想了解更多pycharm的相关内容,可以阅读本专题下面的文章。

2024.04.18

5176

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程