PyCharm 把 **“能跑”** 和 **“能被静态分析器定位”** 视为两回事。
你的测试能通过，说明运行时 `python -m pytest …` 时，解释器确实找到了 `cs336_basics`；但 IDE 的 **代码解析路径（indexing / inspection）** 里并没有把那个目录当作 _Source Root / Site‑Package_，于是就用红波浪线提示 _Unresolved reference_。
下面按出现频率从高到低列几个最常见的原因和对应解决办法——任选其一即可，越往上越推荐。
|方案|操作|解释|
|---|---|---|
|**① 把项目根目录 “Mark as Sources Root”**|在左侧 Project 视图右键含有 `cs336_basics` 的那一层文件夹 (通常就是 `assignment1-basics/`)→ **Mark Directory as → Sources Root**|告诉 PyCharm “这里面的包都算源代码”，它就会把路径加入索引。最快速；对简易作业仓库最常用。|
|**② 做一次可编辑安装**|终端里 cd 到项目根（有 `setup.py` 或 `pyproject.toml`）`pip install -e.`|把 `cs336_basics` 注册到你当前虚拟环境的 site‑packages，PyCharm 会自动把那条路径加到 Interpreter Paths。对后续 import、打包都更通用。|
|**③ 手动加到 Interpreter Paths**|_Settings / Preferences → Project → Python Interpreter → ⚙ → Show All… → Paths_把项目根目录 Add 到列表|等效于修改 `PYTHONPATH`，但只在当前 IDE Interpreter 生效。|
|④ 缺失 `__init__.py`|确保每一级包目录（包括 `cs336_basics`, `tests` 如果想互相 import）都有空 `__init__.py` 文件|没有 `__init__.py` 时 Python3 也能用 _namespace package_ 运行，但 PyCharm 静态分析常会报红。|
|⑤ 改相对导入**（不推荐）**|把`from cs336_basics.nn import …`换成`from..cs336_basics.nn import …`|只有当 _tests_ 本身被当作同级包时才需要；容易和命令行执行路径打架，一般不建议在课程框架里改这点。|
> **最快验证**
>
> 1. 尝试方案 ①：右键 “Sources Root” 后，红线通常会秒消；
>
> 2. 若仍存在，点 **File → Invalidate Caches / Restart…** 让 PyCharm 重新索引。
>
> 3. 实在还有红线，再检查是不是某些子包缺 `__init__.py`。
>
---
# 运行时能过、IDE 还报红的根本原因？
- **运行时**：pytest 先把项目根自动加进 `sys.path`，或你在脚本里 `sys.path.append` 了，所以能 import。
- **IDE 静态检查**：只看它自己维护的 _Interpreter Paths_ 和 _Sources Root_ 列表，没走 Python 启动时那套逻辑；列表里没有 → 标红。
把两边的 _module search path_ 对齐之后，错误提示就会消失。
是的！这是一个很好的观察。让我对比一下 Java 和 C：
# Java 的导入机制
```java
import java.util.List;
import com.example.MyClass;
```
1. 只有 `import` 关键字
2. 面向对象，以类为单位
3. 编译器自动处理依赖
4. 包（package）管理系统
5. 不需要关心实现和声明的分离
# C 的机制
```c
#include <stdio.h> // 头文件导入
extern int some_var; // 外部变量声明
```
1. 有两种机制：
- `#include`：预处理阶段的文件包含
- `extern`：编译阶段的符号声明
2. 以文件为单位
3. 需要手动管理实现和声明
4. 没有包管理系统
# 为什么 C 需要两种机制？
这与 C 语言的编译模型有关：
1. **C 的编译过程**：
```Java
[源文件] → 预处理 → 编译 → 链接 → [可执行文件]
```
2. **Java 的编译过程**：
```Java
[源文件] → 编译 → [字节码] → JVM运行
```
# 实际例子对比
**Java 方式**：
```java
// MyClass.java
public class MyClass {
public static int count = 0;
}
// OtherClass.java
import com.example.MyClass;
public class OtherClass {
void someMethod() {
MyClass.count++; // 直接使用
}
}
```
**C 方式**：
```c
// globals.h
extern int count; // 声明
// globals.c
int count = 0; // 定义
// other.c
#include "globals.h" // 获取声明
void someFunction() {
count++; // 使用
}
```
# 总结
1. Java 的 `import` 更高级，自动处理了很多底层细节
2. C 需要手动管理实现和声明的分离，所以需要 `extern` 和 `include` 两种机制
3. 这反映了两种语言的设计理念：
- Java：高级、自动化、面向对象
- C：底层、手动控制、面向过程