在Visual Studio Code中编写JavaScript的require语句失效，按文件夹整理代码求助

按排查优先级从高到低依次核对 #

1. 相对路径写法细节错误（占报错场景60%以上） #

• 牢记require的路径基准：./ 是当前写require语句的JS文件所在的同级目录，不是VSCode打开的项目根目录。举个常见的项目结构：

  my-project/
  ├─ index.js （当前写require的文件）
  └─ utils/
     └─ tools.js （要引入的目标文件）
  

  在index.js里引入tools.js的正确路径是require('./utils/tools')，如果偷懒写require('./tools')，系统会去index.js的同级目录（也就是my-project根目录）找tools.js，自然找不到文件。
• 后缀名漏写的特殊情况：默认不写后缀时，require只会依次匹配.js/.json/.node后缀的文件，如果你的被引入文件是.cjs/.mjs后缀，必须把完整文件名写上，比如require('./tools.cjs')，否则会识别失败。
• 路径大小写不匹配的隐性问题：Windows本地开发时文件大小写不敏感，写错大小写本地能跑，但一旦代码部署到Linux服务器、或者VSCode开了严格路径校验就会报错。比如实际文件是userTools.js，引入时写成require('./usertools')就会触发加载错误。
• 额外注意路径里的特殊字符：文件名带空格、中文、特殊符号时，要么重命名去掉这些字符，要么确保引入路径和实际文件名完全一致，多一个空格都会加载失败。

2. 模块规范与运行环境不匹配（占报错场景30%左右） #

• 如果项目根目录的package.json里配置了"type": "module"，说明项目默认走ESModule规范，这个时候.js文件里写require()会直接触发require is not defined报错。两种解决方式二选一：
  • 把写require语句的文件后缀改成.cjs，明确告诉Node这是CommonJS规范的文件
  • 把require写法替换成ESModule的import xxx from './fileName.js'
• 如果你是直接在浏览器里跑原生JS、没有任何打包工具（Vite/Webpack等），要注意require()根本不是浏览器原生支持的语法，是Node.js环境独有的CommonJS规范实现，这种情况要么加打包工具把代码做兼容转换，要么换用浏览器原生支持的ESModule语法写引入逻辑。

3. 被引入文件的导出逻辑缺失 #

很多时候不是路径匹配错了，是被引入的文件根本没有对外暴露可访问的内容，导致require拿到空值，看起来像加载完全失效：

• CommonJS规范下，被引入的文件必须通过module.exports = 导出内容把方法、变量对外暴露，没有这行语句，require拿到的就是空对象，调用对应值时会触发“xx is not a function”这类报错。
• 不要在CommonJS环境下混用ESModule的export default语法，两种规范的导出逻辑不兼容，会出现导出值为空的问题。

举个正确的写法参考：
被引入的tools.js：

// 导出一个计算加法的方法
module.exports = (a, b) => a + b

引入的index.js：

const addFn = require('./utils/tools')
console.log(addFn(1, 2)) // 正常输出3

4. VSCode本身的识别缓存问题 #

• 如果代码实际跑起来完全正常，只是VSCode编辑器里飘红提示“找不到模块”，一般是JS语言服务缓存没刷新，不用改代码，按快捷键Ctrl+Shift+P，输入Restart TS Server执行即可重新加载模块识别缓存。
• 核对下VSCode的JS路径校验规则：如果开了严格路径检查，编辑器飘红提示的错误路径可以直接对应修改，不用凭空猜测路径哪里出错。

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