【TypeScript】tsc : 无法加载文件 C:UsersXXXAppDataRoaming\pm\sc.ps1，因为在此系统上禁止运行脚本。

一、背景与问题

在使用TypeScript构建项目时，开发者常会遇到如下错误：

tsc : 无法加载文件 C:\Users\XXX\AppData\Roaming\npm\sc.ps1，因为在此系统上禁止运行脚本。

这个错误本质上是PowerShell执行策略（Execution Policy）限制导致的。PowerShell作为Windows系统的核心命令行工具，默认执行策略为Restricted，禁止运行任意脚本文件。即使使用tsc命令，其底层依赖的npm脚本（如node_modules\.bin\tsc）可能包含PowerShell脚本，从而触发该限制。

此问题在Windows开发环境中尤为常见，尤其是在使用npm安装TypeScript工具链时。理解其原理、解决方法及最佳实践对TypeScript项目开发至关重要。

二、基本原理

1. PowerShell执行策略

PowerShell的执行策略控制脚本文件的运行权限，常见策略包括：

策略名称	描述
Restricted	默认策略，禁止运行本地脚本，允许运行远程脚本
RemoteSigned	允许运行本地脚本，但需签名；远程脚本需签名
AllSigned	所有脚本必须由受信任的发布者签名
Unrestricted	允许运行所有脚本（不推荐，安全风险高）
Bypass	禁用所有策略检查（仅限临时使用）

当执行node_modules\.bin\tsc时，底层调用的tsconfig.json可能包含"compilerOptions"字段，例如：

{
  "compilerOptions": {
    "module": "ESNext",
    "target": "ESNext",
    "outDir": "./dist"
  }
}

而tsc命令会通过node_modules\.bin\tsc调用，其内部可能包含PowerShell脚本（如sc.ps1），导致执行策略限制。

2. npm脚本与PowerShell的关联

在Windows系统中，npm安装的二进制文件（如node_modules\.bin\tsc）本质上是PowerShell脚本。当执行npx tsc或npm run build时，会间接调用这些脚本，从而触发执行策略限制。

三、环境准备

1. 系统要求

Windows 10/11
Node.js 18.x（建议使用 LTS 版本）
TypeScript 4.9+（最新稳定版本）

2. 检查执行策略

运行以下命令查看当前执行策略：

Get-ExecutionPolicy

输出可能为Restricted（默认值）或RemoteSigned等。

3. 修改执行策略（临时方案）

# 临时允许运行所有脚本（仅限当前会话）
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass

⚠️ 警告：Bypass策略会禁用所有安全检查，可能带来安全风险，仅限开发环境使用。

四、核心实现

1. 长期解决方案：配置PowerShell执行策略

方法一：全局设置执行策略

# 设置全局执行策略为 RemoteSigned（推荐）
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# 设置全局执行策略为 Unrestricted（不推荐）
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted

📌 建议使用RemoteSigned策略，既能允许本地脚本运行，又限制远程脚本的执行。

方法二：项目内配置（推荐）

在项目根目录创建.env文件，设置环境变量：

# .env
POWER_SHELL_EXECUTION_POLICY=RemoteSigned

在tsconfig.json中添加自定义字段：

{
  "compilerOptions": {
    "esModuleInterop": true,
    "moduleResolution": "node",
    "outDir": "./dist"
  },
  "env": {
    "POWER_SHELL_EXECUTION_POLICY": "RemoteSigned"
  }
}

2. 配置npm脚本

在package.json中修改脚本为直接调用tsc命令，避免使用npx：

{
  "scripts": {
    "build": "tsc",
    "watch": "tsc --watch"
  }
}

✅ 该方式避免依赖PowerShell脚本，从根本上解决执行策略问题。

3. 使用TypeScript构建工具替代

若项目需要更复杂的构建流程，可使用webpack或Vite等工具：

# 安装构建工具
npm install --save-dev webpack webpack-cli

配置webpack.config.js：

const path = require('path');

module.exports = {
  entry: './src/index.ts',
  output: {
    filename: 'bundle.js',
    path: path.resolve(__dirname, 'dist')
  },
  resolve: {
    extensions: ['.ts', '.js']
  },
  module: {
    rules: [
      {
        test: /\.ts$/,
        use: 'ts-loader',
        exclude: /node_modules/
      }
    ]
  }
};

五、完整案例

1. 项目结构

my-ts-project/
├── package.json
├── tsconfig.json
├── src/
│   └── index.ts
└── dist/

2. 配置文件

tsconfig.json:

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src"]
}

package.json:

{
  "name": "my-ts-project",
  "version": "1.0.0",
  "scripts": {
    "build": "tsc",
    "watch": "tsc --watch"
  },
  "dependencies": {
    "typescript": "^4.9.5"
  },
  "devDependencies": {
    "ts-node": "^10.9.1"
  }
}

3. 代码示例

src/index.ts:

// 导入第三方库（如lodash）
import { map } from 'lodash';

console.log('TypeScript project built successfully!');

执行构建：

npm run build

✅ 构建完成后，dist目录将生成index.js文件。

六、源码解析

1. `tsconfig.json`关键字段

outDir: 指定输出目录，避免与源码目录冲突
strict: 开启严格模式，增强类型检查
esModuleInterop: 兼容CommonJS和ESM模块

2. `package.json`脚本优化

tsc直接调用TypeScript编译器，避免不必要的中间层
--watch参数实现实时编译，适用于开发环境

3. 执行策略设置的底层原理

当执行Set-ExecutionPolicy时，系统会修改注册表项（如HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PowerShell\1\Shell），并更新powershell.exe的启动参数。

七、进阶使用

1. 多环境配置

在.env文件中区分开发/生产环境：

# .env
ENVIRONMENT=development

在tsconfig.json中动态加载配置：

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true,
    "moduleResolution": "node"
  },
  "env": {
    "ENVIRONMENT": "development"
  }
}

2. CI/CD集成

在GitHub Actions中配置构建流程：

name: Build TypeScript Project

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Install dependencies
        run: npm install
      - name: Build project
        run: npm run build

⚠️ 在CI环境中，建议使用RemoteSigned策略，避免频繁修改执行策略。

八、性能与工程实践

1. 性能优化

启用--build参数快速编译
使用--watch模式时，避免重复编译
启用--noEmit仅检查类型，不生成输出文件

2. 异常处理

在tsconfig.json中添加noEmitOnError字段：

{
  "compilerOptions": {
    "noEmitOnError": true
  }
}

3. 安全风险

风险1: 未签名的脚本可能包含恶意代码
风险2: Bypass策略可能导致系统被攻击
解决方案: 使用RemoteSigned策略，定期扫描依赖项

九、常见问题与踩坑

1. 错误示例

# 错误：未设置执行策略导致的编译失败
npm run build

❌ 错误原因：未配置PowerShell执行策略，导致脚本无法运行

2. 正确示例

# 正确：先设置执行策略，再运行构建
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
npm run build

✅ 解决方案：在开发环境中临时设置执行策略

3. 常见错误排查

错误信息	解决方案
tsc : 无法加载文件...	设置PowerShell执行策略
Node.js版本不兼容TypeScript	升级Node.js版本至LTS版本
编译后的文件未生成	检查`outDir`路径是否正确
CI环境中无法运行脚本	在CI配置中设置`RemoteSigned`策略

十、最佳实践

1. 推荐方案

开发环境：使用RemoteSigned策略，配置tsconfig.json优化
生产环境：禁用npx脚本，直接调用tsc命令
CI/CD：在构建流程中设置RemoteSigned策略，避免频繁修改系统设置

2. 不推荐方案

生产环境使用Bypass策略：可能导致系统安全漏洞
依赖未签名的第三方脚本：可能包含恶意代码
在tsconfig.json中使用--watch：可能导致资源占用过高

十一、总结

本文深入分析了TypeScript项目中因PowerShell执行策略导致的脚本加载错误问题，从原理到解决方案进行了系统性探讨。通过配置执行策略、优化构建流程、使用替代工具等方式，可以有效避免该问题。同时，强调了安全与便利的平衡，建议在开发环境中使用RemoteSigned策略，在生产环境中保持严格的执行策略。通过合理配置，开发者可以提升TypeScript项目的构建效率和安全性。