IntelliJ IDEA将项目识别为外部文件无法执行重命名重构问题

报错原文：Cannot perform refactoring. Selected folder is not located inside the project

报错原因 #

即便你已确认项目根目录存在.idea配置文件夹，该报错仍是因为目标文件/所在目录未被纳入IDEA的项目内容根（Content Root）范围。你观察到的test.txt标签为棕色，就是IDEA对非项目内文件的默认标记样式，和报错原因完全吻合。

解决步骤 #

• 使用快捷键Ctrl+Alt+Shift+S直接调出项目结构设置面板，或依次点击顶部菜单栏 File > Project Structure > Modules
• 切换到右侧面板的「Sources」标签页，找到test.txt所在的目录，选中该目录后点击面板上方的「Sources」按钮，将其标记为项目源目录
• 点击「Apply」保存配置后关闭面板，等待IDEA完成项目文件索引
• 索引完成后test.txt的棕色标签会消失，此时再执行重构改名操作即可正常生效

异常情况处理 #

如果执行上述操作后仍存在报错，可重建项目索引修复配置异常：

• 按快捷键Ctrl+Shift+A调出全局操作搜索框
• 输入Invalidate Caches...并选中对应选项
• 在弹出窗口中勾选「Clear file system cache and local history」，点击「Invalidate and Restart」重启IDEA
• 重启后等待IDEA完成全量索引即可正常使用重构功能

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