想从一个面板脚本里删掉一块不再需要的功能，删完运行，脚本还是报错——说找不到某个模块。可你明明已经把用到它的那段逻辑删了。问题在于：你以为删干净了，其实引用它的地方还在。
现象
从脚本里删掉某个功能区块后，程序启动即失败：
ModuleNotFoundError: No module named 'scan_xxx'
或者：
NameError: name 'render_scan_block' is not defined
打开文件一看，主函数里那段调用已经不见了，但文件里还留着几个孤零零的函数定义和它们顶部的导入语句——比如某个跟扫描相关的模块 import scan_xxx，以及只被那个已删功能调用过的 def build_scan_panel(...)。
根因
这种"删了却还在报错"通常由两个因素叠加造成：
第一，删除只删到了主函数，没删附属代码。 一个功能在文件里往往不是连续的一段，而是分散在三处：顶部的 import、中间的函数定义、主流程里的调用。手工删除时，人眼跟着"调用点"走，很容易只删掉主函数里的那几行，而把顶部的 import 和中间的函数定义留下——它们成了孤立的死代码，但只要 import 还在，模块加载时就会真的去导入那个模块，模块不存在就报 ModuleNotFoundError。
第二，删除脚本本身不可靠。 如果用一段自动化脚本来做批量替换删除，而这段脚本"定位失败一次之后仍然继续执行"，它就会在没找到目标的情况下继续往下跑，导致漏删。一次模糊的批量替换，很难保证把"从函数定义到下一个函数定义"的整段都精确切掉。
简单说：引用关系没断干净，代码就不算删掉。
解决
第一步，先定位所有引用点，再动手。 用编辑器或命令行搜一遍这个模块名/函数名，把每一处都列出来：
grep -rn "scan_xxx" your_script.py
第二步，分段精确删除。 对每一个命中位置，从"函数定义那一行"一直删到"下一个函数定义之前"，确保整段函数体连同它的注释一起清掉，不留半截。不要依赖一次模糊的、跨多处的批量替换。
第三步，处理 import。 顶部的 import scan_xxx 也要删掉。删之前可以再确认一次：这个模块在文件里除了被已删功能使用，还有没有别的用途？如果还有，就保留 import；如果没有，一起删。
第四步，验证。 删完直接编译一遍，语法和 import 问题会立刻暴露：
python -m py_compile your_script.py
再真正运行一次脚本，确认功能正常、没有残留报错。
如果你非要用脚本做替换删除，务必先让脚本"定位失败就报错退出"，而不是继续执行——工具本身不可靠，结果就不可靠。
延伸与预防
这条坑可以推广成一个通用原则：删除代码要删到"引用它的地方也没了"才算干净。 判断标准不是"我删了主函数"，而是"全项目搜这个名字，一处都不剩"。
具体到日常实践：
- 删功能时，按"调用点 → 函数定义 → import"三处一起过，缺一不可。
- 删除前先全局搜索，把引用清单列出来，删完再搜一次确认归零。
- 静态检查工具（如未使用导入检测）能帮忙——
ruff、flake8（F401未使用导入、F811重复定义）都能标出那些"没人用还赖着不走"的 import 和定义，删之前跑一遍，删之后跑一遍，就相当稳了。 - 版本控制是最后的保险：真要删错，
git diff能让你一眼看出这次到底动了哪些行，git checkout也能把误删的部分捞回来。删之前先提交一次干净状态，删起来心里才有底。