如何在Qt Creator文件系统视图中移动文件并自动修正引用路径？

标准操作步骤 #

• 切换到Qt Creator左侧边栏的「项目」视图（不要使用文件系统视图），按住Ctrl选中frequency.cpp、frequency.h两个目标文件。
• 右键点击选中的文件，在上下文菜单中选择「移动到目录」选项。
• 在弹出的路径选择弹窗中定位到项目下的Analysis目录，确认选择即可。
• 等待Qt Creator自动完成所有关联修改：该操作会自动完成文件物理移动、构建配置文件（.pro/CMakeLists.txt）路径更新、全项目#include引用路径修正三个动作，无需手动修改任何内容。
• 操作完成后执行一次构建系统刷新（qmake项目执行「运行qmake」，CMake项目执行「重新加载CMake项目」），编译验证即可。

旧版本Qt Creator兼容方案 #

如果你的Qt Creator版本较低，没有「移动到目录」选项，可以用重命名功能实现相同效果：

• 右键点击frequency.h，选择「重构」-「重命名文件」，将文件名修改为Analysis/frequency.h，确认后等待自动修正完成。
• 对frequency.cpp执行相同的重命名操作，修改为Analysis/frequency.cpp即可。

注意事项 #

• 操作前建议先提交当前代码到版本控制系统，避免操作异常可以快速回滚。
• 如果你的项目构建配置中已经提前将Analysis目录加入了INCLUDEPATH，Qt Creator会自动判断是否需要保留路径前缀，不会生成错误的引用语句。

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