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" . 或全局搜索。