VS Code无法识别非TypeScript的NextJS模块问题求助

问题分析 #

你遇到的ts(1149)错误是文件名大小写冲突导致的：Windows文件系统不区分大小写，但VS Code的TypeScript语言服务在处理NextJS类型定义时会严格校验文件名大小写。你导入next/Link（大写L），但实际类型文件是node_modules/next/link.d.ts（小写l），系统将二者识别为不同文件，从而触发报错。

解决方案 #

• 修正导入语句的大小写
  这是最根本的解决方式，还能避免跨平台（Linux/macOS）运行时的潜在问题。把代码中的导入语句从：

  import Link from 'next/Link'
  

  修改为：

  import Link from 'next/link'
  

• 临时调整VS Code设置规避检查（不推荐长期使用）
  如果暂时不想修改代码，可以在VS Code的settings.json中添加配置关闭大小写敏感检查：

  "typescript.preferences.importModuleSpecifierCase": "non-relative",
  "typescript.validate.enable": false
  

  注意：这种方法只是临时规避，会隐藏跨平台兼容性风险。

• 重启TypeScript服务并清理缓存
  执行以下操作让VS Code重新加载类型定义：

  1. 打开命令面板（Ctrl+Shift+P）
  2. 输入TypeScript: Restart TS Server并执行
  3. 关闭并重新打开VS Code

为什么TypeScript项目无此问题？ #

带TypeScript的NextJS项目默认启用严格类型检查配置，VS Code会自动按照正确大小写提示导入，避免了手动输入错误；而无TypeScript的JS项目中，自动导入未严格校验大小写，容易出现手动输入错误的情况。

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