解决VS Code中ESLint“运行脚本被禁用”错误：全局安装指南-js教程-PHP中文网

解决VS Code中ESLint“运行脚本被禁用”错误：全局安装指南

聖光之護

发布： 2025-10-07 10:13:15

原创

255人浏览过

解决VS Code中ESLint“运行脚本被禁用”错误：全局安装指南

针对在VS Code中启用ESLint时遇到的“运行脚本被禁用”错误，本教程提供了一份详细的解决方案。核心在于强调全局安装ESLint时需要使用管理员权限，以确保npm包能够正确安装并配置系统路径，从而避免脚本执行策略限制导致的问题，确保ESLint顺利运行。

问题概述与原因分析

当开发者尝试在系统上全局安装eslint（通常通过npm install eslint -g命令），并在之后尝试运行eslint --version进行验证时，可能会遇到类似“file c:\users...\eslint.ps1 cannot be loaded because running scripts is disabled on this system.”的错误信息。这个错误表明系统（尤其是windows上的powershell）阻止了特定脚本的执行。

虽然错误信息直接指向了脚本执行策略，但更深层次的原因往往是由于npm在全局安装包时，需要创建符号链接、修改系统环境变量或在系统目录中写入文件。这些操作通常需要管理员权限。如果安装过程没有获得足够的权限，ESLint相关的脚本文件（如eslint.ps1）可能没有被正确创建或配置，导致后续执行时出现权限或策略相关的错误。因此，解决此问题的关键在于以正确的权限执行ESLint的全局安装。

解决方案：使用管理员权限安装ESLint

为了确保ESLint及其相关脚本能够正确安装并被系统识别，必须使用管理员权限执行全局安装命令。

针对Windows用户

在Windows操作系统中，您需要以管理员身份运行命令提示符（CMD）或PowerShell。

打开管理员模式的终端：
- 在搜索栏输入“CMD”或“PowerShell”。
- 右键点击“命令提示符”或“Windows PowerShell”应用程序。
- 选择“以管理员身份运行”。
- 如果出现用户账户控制（UAC）提示，请点击“是”允许。
执行全局安装命令： 在以管理员身份运行的终端中，输入以下命令并按回车键执行：
```
npm install eslint -g
```
登录后复制

针对Linux/macOS用户

在Linux或macOS操作系统中，您可以使用sudo命令来获取临时的管理员权限（超级用户权限）。

打开终端： 打开您的终端应用程序。
执行全局安装命令： 在终端中输入以下命令，并根据提示输入您的用户密码：
```
sudo npm install eslint -g
```
登录后复制

验证ESLint安装

完成上述步骤后，您可以尝试验证ESLint是否已成功安装并可执行。

Snyk Code

当下比较流行的代码安全检查工具

查看详情

打开一个新的非管理员终端（可选，但推荐）： 为了模拟日常使用环境，可以打开一个普通的命令提示符或终端窗口。
运行版本检查命令：
```
eslint --version
```
登录后复制
如果一切顺利，您应该会看到ESLint的版本号，而不是之前的错误信息。

在VS Code中集成ESLint

ESLint成功安装并可执行后，为了在VS Code中获得实时代码检查和修复功能，您还需要安装VS Code的ESLint扩展。

打开VS Code。
前往扩展视图： 点击侧边栏的方块图标（或按下Ctrl+Shift+X）。
搜索并安装ESLint扩展： 在搜索框中输入“ESLint”，找到由“Dirk Baeumer”发布的ESLint扩展，然后点击“安装”。

安装扩展后，VS Code通常会自动检测项目中安装的ESLint，并在您打开JavaScript/TypeScript文件时提供代码检查和修复建议。您可能需要重新加载VS Code窗口（Ctrl+Shift+P -> Reload Window）以确保扩展完全激活。

注意事项

全局安装与项目本地安装： 尽管本教程侧重于全局安装解决特定错误，但在实际项目中，更推荐在每个项目内部本地安装ESLint（npm install eslint --save-dev），并通过VS Code扩展配置使用项目本地的ESLint版本。这有助于避免版本冲突，并确保项目依赖的ESLint版本与项目配置保持一致。
PowerShell执行策略： 虽然本教程通过管理员权限安装解决了问题，但如果未来遇到其他脚本执行问题，并且确定需要修改PowerShell的执行策略，可以使用Set-ExecutionPolicy RemoteSigned或Set-ExecutionPolicy Unrestricted命令。请注意，修改执行策略存在安全风险，应谨慎操作。
PATH环境变量： 确保npm的全局安装目录已添加到系统的PATH环境变量中。通常，当您安装Node.js时，npm会自动配置好这一点。如果eslint命令仍然无法识别，可能需要手动检查和添加。

总结

解决在VS Code中启用ESLint时遇到的“运行脚本被禁用”错误，核心在于确保ESLint的全局安装过程拥有足够的系统权限。通过以管理员身份运行命令提示符/PowerShell（Windows）或使用sudo（Linux/macOS）执行npm install eslint -g命令，可以有效避免因权限不足导致的安装问题和后续的脚本执行错误。正确安装并配置ESLint后，结合VS Code的ESLint扩展，将极大提升代码质量和开发效率。

以上就是解决VS Code中ESLint“运行脚本被禁用”错误：全局安装指南的详细内容，更多请关注php中文网其它相关文章！