在Bubbly项目中完成项目重命名，看似简单，但若未能同步更新所有关联位置，轻则导致构建失败，严重时甚至运行时无法找到主类。此操作涉及工程文件名、配置文件中的标识符、源码内的硬编码引用，以及构建产物的显示名称，任何遗漏都可能引发问题。 下面直接梳理标准操作流程，助你避开常见陷阱。 首先，务必关闭Bubbly IDE或VS Code等编辑器，随后在文件管理器中定位项目文件夹，右键重命名为新名称（例如从`hello-world`更改为`my-bubbly-app`），按回车确认。这一步是后续所有操作的基础——若路径不统一，后续任何修改都会因路径错误而失效。 **【关键】务必将同名的 `.bubblyproj` 文件一并重命名**。项目根目录下有一个与文件夹同名、扩展名为`.bubblyproj`的工程配置文件（例如原名为`hello-world.bubblyproj`），现需同步改为`my-bubbly-app.bubblyproj`。否则Bubbly加载时会直接报错“Project file not found”。 --- ### 修改项目配置文件中的名称字段 使用文本编辑器打开 `.bubblyproj` 文件，定位 `` 标签，将旧名称（例如 `HelloWorld`）替换为新名称（例如 `MyBubblyApp`），保存。接着继续查找 `` 和 `` 两个标签，确保它们的值与新项目名完全一致。若存在 ``，同样更新为匹配的新命名空间（例如 `MyBubblyApp`）。 此处需特别注意：这三个字段缺一不可，遗漏任何一个都会导致最终生成的文件名或程序集名称错误。 --- ### 更新源码中硬编码的项目引用 打开 `src/Program.bbl`（或项目的主入口文件），检查是否包含类似 `project "HelloWorld"` 或 `appname: "HelloWorld"` 的声明，全部替换为新名称。 然后在整个项目范围内搜索旧名称（按 Ctrl+Shift+F，关键词带英文引号，例如 `"HelloWorld"`），排除 `node_modules` 和 `dist` 目录。重点检查 `package.json` 中的 `"name"` 字段、`build.config.js` 中的 `output.dir` 和 `appInfo.title`，每一处都需替换为新项目名。 若项目启用了模块化路由或资源加载，切勿遗漏 `public/manifest.json` 和 `public/index.html` 中的 `name`、`short_name`、`