Angular 5项目启动报错：找不到名称'$'，跨环境运行异常求助

我之前也碰到过一模一样的问题！这种报错大概率是项目的类型检查工具（尤其是用TypeScript的项目）识别不到jQuery的类型定义，或者jQuery本身没在当前环境里正确引入导致的，给你几个实用的排查和解决方向：

• 检查并安装jQuery的类型定义包
  如果你的项目用了TypeScript，光装jquery本体是不够的，TS需要对应的类型声明才能识别$。执行这个命令安装类型包：

  npm install @types/jquery --save-dev
  

  装完记得重启下编辑器（比如VS Code有时候会缓存旧的类型信息，刷新一下才会生效）。就算是纯JS项目但启用了TS的类型检查，这个步骤也同样需要。

• 确认jQuery是否正确引入到项目中
  办公电脑可能是全局引入了jQuery（比如通过HTML里的script标签或者构建工具的全局注入），但当前电脑的环境没配置这一步：

  • 检查项目的入口文件（比如main.js/main.ts），有没有手动引入：import $ from 'jquery'；
  • 如果是Webpack项目，看看配置里有没有用ProvidePlugin全局注入$：

    // webpack.config.js
    const webpack = require('webpack');
    module.exports = {
      plugins: [
        new webpack.ProvidePlugin({
          $: 'jquery',
          jQuery: 'jquery'
        })
      ]
    };
    

  • 也可以检查项目的HTML文件，有没有引入jQuery的CDN链接，比如<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>，当前电脑如果没联网或者链接失效也会出问题。

• 检查TypeScript配置（TS项目专属）
  打开tsconfig.json，看看compilerOptions里的types数组有没有包含jquery，确保类型定义被加载：

  {
    "compilerOptions": {
      "types": ["jquery", "...其他你需要的类型包"]
    }
  }
  

  同时确认include字段包含了项目的所有源码文件，避免类型定义没被正确扫描到。

• 清理缓存再重试
  有时候缓存会搞出奇怪的问题，试试这些操作：

  • 删除node_modules文件夹和package-lock.json（或yarn.lock），重新执行npm install；
  • TS项目可以执行npx tsc --clearCache清理类型缓存；
  • 重启编辑器，比如VS Code按Ctrl+Shift+P，选择「TypeScript: Reload Project」刷新项目类型信息。

如果以上方法都没用，建议对比办公电脑和当前电脑的package.json依赖版本，可能是你装的最新版jquery或@types/jquery和项目有兼容问题，试试安装和办公电脑完全一致的版本：

npm install jquery@x.x.x @types/jquery@x.x.x

（把x.x.x换成办公电脑里对应的版本号）

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