VSCode中跨文件触发Cannot redeclare block-scoped variable错误的解决求助

这种情况我之前帮好几个开发者排查过，刚装的VSCode就碰到这个问题确实挺闹心的——本质原因是VSCode默认的语言服务（尤其是TypeScript/JavaScript的类型检查）会把同目录下未被标记为模块的文件，都归到同一个全局作用域里，所以两个文件里的同名函数就会被判定为重复声明。

下面给你几个实用的解决办法，按优先级推荐：

• 快速应急：用ES模块隔离作用域
  这是最快见效的方法，不需要改任何配置，只要在每个出现冲突的JS/TS文件顶部加一行：

  export {};
  

  加了这行之后，VSCode就会把这个文件当成独立的ES模块，模块内部的变量、函数都是私有作用域，不会和其他文件的同名内容冲突。

• 项目级规范：创建jsconfig.json/tsconfig.json
  如果是正经的项目，推荐在项目根目录创建配置文件，从根源上解决问题：

  • 要是你写的是JavaScript，创建jsconfig.json，内容参考：

    {
      "compilerOptions": {
        "module": "ESNext",
        "target": "ES6"
      },
      "include": ["src/**/*"], // 替换成你项目的代码目录
      "exclude": ["node_modules"]
    }
    

  • 要是TypeScript项目，创建tsconfig.json，内容参考：

    {
      "compilerOptions": {
        "module": "ESNext",
        "target": "ES6",
        "strict": true // 按需开启严格模式，新手可以先设为false
      },
      "include": ["src/**/*"],
      "exclude": ["node_modules"]
    }
    

  这个配置会告诉VSCode，你的项目文件都遵循模块规范，不会再把它们当成全局文件处理，同时还能统一项目的代码检查规则。

• 调整VSCode全局设置
  如果你只是写零散的脚本，不想用模块或配置文件，也可以修改VSCode的默认设置：

  1. 按Ctrl+,（Windows/Linux）或Cmd+,（Mac）打开设置面板
  2. 搜索javascript.implicitProjectConfig.checkJs，把这个选项关掉——它默认开启时，VSCode会自动对JS文件做类型检查，把它们当成全局文件
  3. 或者搜索javascript.implicitProjectConfig.module，把值设置为ESNext，让VSCode默认用模块方式处理JS文件

• 旧时代应急方案：用IIFE包裹代码（不推荐）
  这是比较老的做法，适合临时救急：把每个文件的代码都包裹在立即执行函数里，隔离局部作用域：

  (function() {
    // 你的函数和代码都写在这里
    function myDuplicateFunction() {
      // ...
    }
  })();
  

  不过这个方法不够优雅，也不符合现代JS的开发规范，只建议临时用用。

优先推荐前两种方法，既符合现代前端的开发习惯，也能避免后续再碰到类似的作用域冲突问题。

内容来源于stack exchange