Symfony AssetMapper与TypeScript：如何修复“找不到模块”linting错误？

核心问题本质 #

你碰到的问题是TypeScript无法识别AssetMapper通过importmap管理的依赖类型，而且@types/stimulus不能用importmap:require安装——这个命令只负责前端运行时依赖，类型定义得换方式处理。

分步解决方法 #

1. 配置tsconfig.json让TypeScript识别AssetMapper路径 #

在项目根目录创建/修改tsconfig.json，重点配置路径映射和类型文件范围：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "baseUrl": ".",
    "paths": {
      "@hotwired/stimulus": ["vendor/@hotwired/stimulus/dist/stimulus.d.ts"],
      "@hotwired/stimulus/*": ["vendor/@hotwired/stimulus/dist/*"]
    },
    "types": ["@hotwired/stimulus"]
  },
  "include": ["assets/controllers/**/*.ts", "vendor/@hotwired/stimulus/dist/*.d.ts"],
  "exclude": ["node_modules", "public"]
}

• 直接指向AssetMapper安装的stimulus类型定义文件（.d.ts），不是JS文件
• moduleResolution: "bundler"适配AssetMapper的模块解析逻辑
• include必须包含你的控制器目录和vendor下的类型文件

2. 手动安装@types/stimulus到正确位置 #

importmap:require装类型包报错是正常的，按以下步骤手动处理：

• 临时用npm下载类型包：npm install @types/stimulus --save-dev
• 把node_modules/@types/stimulus整个目录复制到项目的vendor/@types/stimulus下
• 不需要的话可以删掉node_modules里的这个包
• 最后在tsconfig的paths里加一行：

"@types/stimulus": ["vendor/@types/stimulus/index.d.ts"]

3. 修正控制器的导入语法 #

别用相对路径指向vendor的JS文件，保持标准Stimulus导入即可：

import { Controller } from '@hotwired/stimulus';

export default class extends Controller {
  // 你的控制器逻辑
}

TypeScript会通过tsconfig的路径映射找到类型文件，AssetMapper构建时会通过importmap解析运行时文件。

4. 重启IDE的TypeScript服务 #

如果配置完还是没类型提示，重启IDE的TypeScript服务（比如VSCode里按Ctrl+Shift+P，选「TypeScript: Restart TS Server」），确保IDE读取了新的配置。

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