JetBrains Academy中如何在test_task.py里访问task.py文件？

一、可行的解决方法 #

1. 调整PyCharm的Sources Root配置（推荐，无需改代码） #

右键点击项目中存放task.py的根目录，选择Mark Directory as > Sources Root。这样PyCharm会自动把该目录加入Python的模块搜索路径，from task import summe就能正常找到模块，完全不用修改现有代码结构。

2. 修正test_task.py中的sys.path配置（如果不想改IDE设置） #

如果之前的sys.path修改无效，大概率是路径没取对。在test_task.py的最顶部添加以下代码，确保task所在目录被加入搜索路径：

import sys
from pathlib import Path

# 假设test_task.py在tests子目录，task.py在项目根目录，取当前文件的父级父目录
sys.path.insert(0, str(Path(__file__).parent.parent))
from task import summe

Path(__file__)能准确获取当前测试文件的绝对路径，避免相对路径的上下文问题。

二、为什么默认模板无法正常工作 #

JetBrains Academy的edu任务模板是为在线课程环境设计的：在线环境会自动配置好Python的模块搜索路径，确保测试文件能直接导入task模块。但当你在本地PyCharm中打开项目时，默认的IDE运行配置并没有继承在线环境的路径设置——比如测试运行器的工作目录可能被设为测试文件所在的子目录，或者task所在目录没被标记为Sources Root，导致Python找不到task模块。

另外，edu任务的目录结构是JetBrains自定义的，和常规Python项目结构有差异，本地PyCharm的默认规则无法自动适配这种自定义结构，所以模板代码在本地会失效。

三、JetBrains无相关文档的可能原因 #

1. 场景定位问题：JetBrains Academy的核心用户是课程学习者和基础创作者，本地调试自定义edu任务属于进阶场景，官方文档优先覆盖课程创建的基础流程，没针对这种边缘场景做详细说明。
2. 环境差异问题：不同版本的PyCharm、JetBrains Academy插件，甚至不同的操作系统，路径配置的细节都有差异，官方很难写出通用的文档。
3. 依赖基础常识：模块导入问题本质是Python路径的基础知识点，官方可能认为用户应该具备这部分常识，所以没单独在Academy文档中重复说明。

内容的提问来源于stack exchange，提问作者Reto Schmid