为隔离的开发运行管理浏览器 profile

​

工作原理

1. 当 profile: false 或 EXTENSION_USE_SYSTEM_PROFILE=true 时，使用系统 profile 模式
2. 显式的 profile 路径（如果提供）
3. 受管理的 profile 模式（默认）
   • 默认是临时（ephemeral）
   • 当 persistProfile: true 或 keepProfileChanges: true 时则保持持久

​

--profile 的取值如何被读取

• --profile=false（或配置中的 profile: false）表示使用浏览器自己的默认 profile。
• --profile=true 表示受管理的默认值，等同于不设置这个选项。
• 其他任何字符串都会被当作显式的 profile 路径。

​

Firefox 及其他 Gecko 浏览器上的系统 profile 模式

Firefox can't load the add-on in its own profile, so it was not launched.
SET BY --profile=false
Remote debugging is off in a browser's own profile, and the add-on can only be installed over it.
To fix, drop --profile=false, then let Extension.js manage the profile or pass --profile=<path> to use a profile of your own.

• 去掉 --profile=false（以及 profile: false 或 EXTENSION_USE_SYSTEM_PROFILE），让 Extension.js 管理 profile 并安装附加组件。加上 persistProfile: true 可以在多次运行之间保留登录和状态，也可以用 copyFromProfile 从已有 profile 为受管理 profile 播种。
• 传入 --profile=<path>，用你自己的 profile 目录启动。Extension.js 会把附加组件安装进去。

​

profile 能力

​

用 copyFromProfile 播种

​

profile 模式

• dist/extension-js/profiles/<browser>-profile/<...>

• dist/extension-js/profiles/<browser>-profile/dev

​

在 extension.config.* 中配置

export default {
  browser: {
    chrome: {
      // Use your own profile folder:
      profile: "path/to/custom/profile",
    },
    firefox: {
      // Keep a stable managed profile for repeated sessions:
      persistProfile: true,
    },
    edge: {
      // Keep changes across runs and seed once from an existing profile:
      keepProfileChanges: true,
      copyFromProfile: "/path/to/existing/profile",
    },
  },
};

export default {
  commands: {
    dev: {
      persistProfile: true,
    },
  },
};

​

CLI 用法

extension dev --browser=chrome --profile=/path/to/custom/profile

​

生命周期说明

• Extension.js 为每次运行创建一个临时的受管理 profile。
• Extension.js 在多次运行之间复用持久的受管理 profile（dev）。
• 每个临时 profile 都带有一个 .extension-js-managed-profile 标记文件。浏览器退出时，Extension.js 只删除带有该标记的目录，因此被保留的 profile 和显式指定的 profile 永远不会被回收。
• Extension.js 还会在下一次启动时清扫陈旧的带标记 profile。可通过 EXTENSION_TMP_PROFILE_MAX_AGE_HOURS 控制最大保留时长（默认 12 小时）。
• 每次启动 Firefox 时，Extension.js 都会删除该 profile 的 startupCache 目录。否则被固定或持久化的 profile 可能在整次 dev 重启之后仍然提供陈旧的扩展代码。

​

被锁定的 Chromium profile

​

隐私

​

最佳实践

• 基线测试用受管理临时 profile：减少隐藏状态，降低不稳定复现的概率。
• 长时间调试会话用 persistProfile：在多次运行之间保留 auth / 会话 / devtools 状态。
• 按浏览器家族保持各自的自定义 profile：避免跨浏览器互相污染。
• 有意识地使用系统 profile 模式：适合在 Chromium 家族浏览器上复现问题，但隔离性不如受管理 profile。Extension.js 会拒绝在这种模式下启动 Gecko 浏览器。

​

下一步

• 进一步了解 浏览器 preferences。
• 进一步了解 浏览器 flag。