Chrome扩展重复调用报错：标识符已定义，如何解决？

问题原因 #

你遇到的Uncaught SyntaxError: Identifier 'BadukFlash' has already been declared错误，本质是每次触发扩展功能时，baduk_flash.js脚本会重复执行，而脚本顶部用let/const/class声明了BadukFlash——这类声明不允许在同一作用域重复定义，第二次执行就会抛出语法错误。

可行解决方法 #

1. 先判断再声明 #

在定义BadukFlash前，先检查它是否已存在于全局作用域，避免重复声明：

// 替换原有的直接声明代码
if (typeof BadukFlash === 'undefined') {
  // 如果是类
  class BadukFlash {
    // 你的类实现逻辑
  }
  // 如果是函数，也可以这么写：
  // function BadukFlash() { ... }
}

2. 用IIFE隔离作用域 #

把整个脚本包裹在立即执行函数表达式里，让BadukFlash只存在于局部作用域，每次执行脚本都不会污染全局命名空间：

(function() {
  class BadukFlash {
    // 类的具体实现
  }

  // 这里执行截图下载的逻辑
  const flashInstance = new BadukFlash();
  flashInstance.captureAndDownload();
})();

这样每次调用扩展，都是在独立的作用域内创建类，不会和之前的执行产生冲突。

3. 封装成单例模块 #

如果需要复用实例，可以用模块模式实现单例，既避免重复声明，又能减少实例创建开销：

const BadukFlashModule = (function() {
  let instance = null;

  class BadukFlash {
    // 类的核心逻辑
    captureAndDownload() {
      // 截图下载代码
    }
  }

  return {
    getInstance: function() {
      if (!instance) {
        instance = new BadukFlash();
      }
      return instance;
    },
    startCapture: function() {
      this.getInstance().captureAndDownload();
    }
  };
})();

// 触发时调用模块方法
BadukFlashModule.startCapture();

4. 调整脚本注入模式 #

如果你的扩展是通过chrome.scripting.executeScript注入脚本，可以添加world: 'ISOLATED'选项，让每次注入的脚本运行在隔离环境，互不干扰：

// 扩展后台脚本中的注入代码
chrome.scripting.executeScript({
  target: { tabId: 当前标签ID },
  files: ['baduk_flash.js'],
  world: 'ISOLATED'
});

注意：隔离环境无法直接访问页面全局变量，如果需要操作页面DOM，建议用func参数传递执行函数，或者通过Chrome的消息API和页面通信。

验证方式 #

修改代码后，在不刷新页面的情况下连续触发扩展功能，检查浏览器控制台是否还出现重复声明的错误，同时确认截图下载功能正常运行。

内容的提问来源于stack exchange，提问作者Terrence Brannon