问题描述与现状
PyCharm作为一款功能强大的Python集成开发环境，其提供的重构功能，特别是文件移动（Move）操作，能够智能地更新项目中的导入路径，极大地提高了开发效率。然而，许多用户发现，在执行文件移动操作时，PyCharm还会自动检测并移除文件中未使用的导入语句。尽管在一般情况下，移除冗余导入有助于代码整洁，但在某些特定场景下，例如代码正在开发中、调试需要保留某些导入、或者有特定工具依赖这些导入但PyCharm无法识别其使用时，这种自动移除行为可能导致不便甚至错误。
目前，PyCharm并没有提供一个直接的配置选项来全局禁用此功能。根据JetBrains官方问题跟踪系统（如PY-54707），此行为已被确认为一个已知问题，并且社区中对此也有广泛讨论，表明这并非个别现象，而是重构机制的固有特性。这意味着开发者无法通过修改PyCharm设置来阻止这种自动移除，尤其是在涉及大量文件移动时，手动检查和恢复导入变得不切实际。
局部解决方案：保护特定导入
尽管没有全局禁用选项，但存在一种局部解决方案，可以用于保护文件中的特定导入语句不被PyCharm在重构时自动移除。这通过在导入语句上方添加一个特定的注释来实现。
使用 noinspection 注释
PyCharm支持多种 noinspection 注释，用于指示IDE忽略特定代码检查。在这种情况下，我们可以利用 # noinspection PyUnresolvedReferences 注释来“欺骗”PyCharm的静态分析器，使其不对该行导入进行进一步处理，从而避免其在重构时被标记为“未使用”并移除。
示例代码：
假设你有一个名为 my_module 的模块，其中包含一个你希望在文件移动时保留的导入 from some_package import SomeClass，即使它在当前文件中看似未使用。你可以这样修改你的代码：
# noinspection PyUnresolvedReferences
from some_package import SomeClass
# 你的其他导入和代码
import os
import sys
def my_function():
# 这里可能没有直接使用 SomeClass，但你希望保留导入
print("Function executed.")
if __name__ == "__main__":
my_function()在这个例子中，# noinspection PyUnresolvedReferences 注释会告诉PyCharm忽略紧随其后的 from some_package import SomeClass 这一行的任何潜在的未解析引用警告。实际上，它的作用是让PyCharm在执行重构的导入清理逻辑时，不对这一行导入进行移除操作，因为它已经被明确指示“不要动它”。
注意事项
- 局部性： 这种方法是针对单个导入语句的局部解决方案。你需要在每个你希望保护的导入语句上方添加相应的注释。
- 非官方目的： 使用 # noinspection PyUnresolvedReferences 来防止导入移除并非其主要设计目的。它的主要作用是抑制未解析引用的警告。然而，在当前没有直接禁用导入移除功能的情况下，它被发现可以间接达到保护导入的效果。
- 代码可读性： 过度使用 noinspection 注释可能会降低代码的可读性，因为它掩盖了IDE本应提示的潜在问题。因此，建议仅在确实需要保留未使用导入的特定场景下谨慎使用。
- 持续关注： 由于这是一个已知问题，JetBrains未来可能会提供更完善的解决方案或配置选项。建议开发者关注PyCharm的官方更新日志和问题跟踪系统，以获取最新信息。
- 替代策略： 如果你发现自己经常需要保留“未使用”的导入，可能需要重新审视你的代码结构或开发流程。例如，确保所有必要的导入都被实际使用，或者将相关功能封装在更合理的模块中。
总结
PyCharm在文件移动重构时自动移除未使用导入的行为，是其智能重构功能的一个副作用，目前无法通过全局设置禁用。对于需要保留特定导入的场景，开发者可以采用在导入语句上方添加 # noinspection PyUnresolvedReferences 注释的局部解决方案。虽然这并非最理想的方式，但在官方提供更直接的配置之前，它提供了一种有效的应对策略。建议开发者权衡其利弊，并持续关注PyCharm的更新，期待未来能有更灵活的选项。
