Bubbly怎么修改项目名称
来源:互联网
更新时间:2026-06-15 09:51
在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`、``,否则浏览器标签页仍然显示旧名称,白改了一通。
---
### 清理缓存并验证构建
改完所有地方后,按以下顺序验证:
1. 在终端进入项目根目录,执行 `bubbly clean`。
2. 然后执行 `bubbly build`。
3. 如果构建时报错 `Error: Cannot find module './dist/HelloWorld.js'`,说明某处路径没更新——立即检查 `build.config.js` 中 `entry` 字段和 `output.filename` 是否还残留旧名。
4. 构建成功后,运行 `bubbly serve`,访问 `http://localhost:8080`,确认页面标题、控制台输出、打包后的JS文件名都已经是新名称。
整个过程并不复杂,但每一步都环环相扣。只要按这个清单走一遍,项目改名就不会翻车。