PyCharm重命名项目需先关闭项目再重命名文件夹，再通过修改.idea/.name文件更新UI显示名，并检查运行配置、解释器路径及隐式引用。
PyCharm 里改项目名 ≠ 改文件夹名
直接在操作系统里重命名项目文件夹，PyCharm 启动时会报错 Project not found 或提示“项目已损坏”，因为 PyCharm 的配置（如 .idea 目录、workspace.xml、运行配置）都依赖原始路径。真正的“重命名项目”是让 PyCharm 认出新名字并正常加载，核心动作其实是**同步更新项目根目录路径和内部引用**。
必须先关闭项目再重命名文件夹
PyCharm 会锁住 .idea 目录和某些临时文件，如果开着项目就去改文件夹名，Windows 可能提示“文件正在被使用”，macOS/Linux 则可能造成配置损坏。正确顺序是：
- 点击菜单 File → Close Project（不是退出 PyCharm）
- 在文件管理器中将项目文件夹重命名为目标名称（例如从
my_project改为data_processor） - 重新打开 PyCharm，选择 Open → 选中新文件夹
此时 PyCharm 会重建部分缓存，但项目名仍显示旧名——这是下一步要处理的。
修改 PyCharm 显示的项目名（即标题栏和项目视图顶部）
PyCharm 窗口标题和左侧项目视图顶部显示的“项目名”，取自 .idea/.name 文件内容。这个文件是纯文本，手动编辑即可：
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 用任意文本编辑器打开项目根目录下的
.idea/.name - 把里面的内容替换成你想要的新项目名（比如
data_processor），保存 - 重启 PyCharm（或右键项目根目录 → Reload project from disk）
注意：.name 文件不参与构建或运行，只影响 UI 显示；如果该文件不存在，PyCharm 默认用文件夹名作为项目名。
检查运行配置和解释器路径是否受影响
重命名文件夹后，PyCharm 通常能自动修复大部分路径，但以下两项容易漏掉：
-
Run/Debug Configurations中的Working directory：确认它指向新文件夹路径（如$PROJECT_DIR$是变量，一般没问题；但若写死绝对路径就得手动改） - Python 解释器路径中的项目相关 site-packages（尤其用 virtualenv）：如果虚拟环境放在项目内（如
venv/），路径没变，无需操作；如果解释器路径硬编码了旧项目名，则需在 Settings → Project → Python Interpreter 里重新配置
改完建议执行一次 File → Invalidate Caches and Restart → Just Restart，避免旧缓存导致模块导入异常或代码跳转失效。
真正麻烦的不是改名动作本身，而是那些藏在运行配置、Git remote URL、.env 文件或 README 里的隐式引用——它们不会自动更新，得靠你自己搜 grep -r "old_name" . 或全局搜索。
