工作流程常见问题

如何更新 Plasmo 到最新版本？

如果您使用 pnpm 包管理器，请运行以下命令：

pnpm up -L plasmo

对于其他包管理器（如 npm 或 yarn），您需要清除锁定文件后重新运行安装命令来获取最新版本：

# 对于 npm
rm package-lock.json && npm install
 
# 对于 yarn
rm yarn.lock && yarn install

或者，您也可以手动在 package.json 中更新 Plasmo 的版本号，然后重新运行安装命令。

如何使用 Plasmo 的实验版本？

如需体验 Plasmo 的最新实验功能，请将 package.json 中的版本号改为 lab：

{
  "dependencies": {
    "plasmo": "lab"
  }
}

然后执行安装命令：

pnpm install
# 或
npm install
# 或
yarn install

遇到错误时该如何处理？

当遇到问题时，请使用 --verbose 标志运行命令来获取详细日志信息：

plasmo --verbose

然后将完整的输出内容粘贴到错误报告的日志部分。详细的错误信息能帮助我们更快速地定位和解决问题 🙏

官方支持哪些浏览器构建目标？

Plasmo 框架官方支持以下构建目标组合：

• chrome-mv3（默认目标，Chrome Manifest V3）
• firefox-mv2（Firefox Manifest V2）
• firefox-mv3（实验性，Firefox Manifest V3）

此外，基于 Chromium 内核的浏览器通常也能良好支持，例如：

• edge-mv3（Microsoft Edge）
• brave-mv3（Brave 浏览器）
• opera-mv3（Opera 浏览器）

Safari 浏览器支持说明

对于 Safari 浏览器（safari-mv3），目前需要一些额外的处理步骤：

1. 首先使用 Plasmo 构建 safari-mv3 目标
2. 然后使用苹果官方的 safari-web-extension-converter  工具进行格式转换

具体的技术细节和当前限制请参考相关开发进展 。

构建过程中如何优化性能？

如果您遇到构建速度较慢的问题，可以尝试以下优化措施：

1. 启用依赖提升（适用于稳定依赖）：

   plasmo build --hoist

2. 禁用源映射生成（仅限生产环境）：

   plasmo build --no-source-maps

3. 使用更快的包管理器：pnpm 通常比 npm 和 yarn 具有更好的性能表现

如何调试开发服务器的连接问题？

如果开发服务器的热重载功能无法正常工作，请检查：

1. 防火墙设置是否允许本地端口通信
2. 浏览器扩展是否已正确加载开发版本
3. 使用 --hmr-port 标志指定不同的端口尝试连接

plasmo dev --hmr-port=3000