在VS中运行Angular 14项目报错：未知参数port、ssl、ssl-cert、ssl-key

问题核心 #

将Angular 14项目的ClientApp复制到原Visual Studio ASP.NET项目后，执行npm start报错：

InvalidOperationException: The NPM script 'start' exited without indicating that the Angular CLI was 
listening for requests. The error output was: Error: Unknown arguments: port, ssl, ssl-cert, ssl-key

但直接替换环境变量后的ng serve命令可正常运行，说明问题出在脚本执行环境或依赖配置上。

解决步骤 #

1. 确认Angular CLI版本一致性 #

检查ClientApp/package.json中@angular/cli版本是否为14.2.4（与你本地/全局版本匹配），若不一致，执行：

npm install @angular/cli@14.2.4 --save-dev

2. 重置依赖环境 #

删除ClientApp下的node_modules文件夹和package-lock.json文件，重新安装依赖：

npm install

此举可清除原项目残留的旧版本Angular依赖。

3. 确保run-script-os依赖存在 #

你的start脚本依赖run-script-os实现跨平台命令区分，检查package.json的devDependencies中是否包含该包，若没有则安装：

npm install run-script-os --save-dev

4. 排查环境变量解析问题 #

暂时将start:windows和start:default脚本中的%npm_package_name%替换为你的实际项目包名（比如myproject），测试是否能正常运行：

"start:windows": "ng serve --port 44455 --ssl --ssl-cert %APPDATA%\\ASP.NET\\https\\myproject.pem --ssl-key %APPDATA%\\ASP.NET\\https\\myproject.key",
"start:default": "ng serve --port 44455 --ssl --ssl-cert $HOME/.aspnet/https/myproject.pem --ssl-key $HOME/.aspnet/https/myproject.key"

若此方法有效，说明npm_package_name环境变量在run-script-os的执行上下文未被正确解析。

5. 检查ASP.NET Core的Spa配置 #

打开原项目的Properties/launchSettings.json，查看Spa配置是否额外传递了参数给start脚本：

"spa": {
  "startupCommand": "npm start",
  "arguments": ""
}

若原有配置传递了--port等参数，这些参数会被附加到npm start后，导致run-script-os错误传递给ng serve，需清空arguments字段。

6. 跳过跨平台脚本（仅Windows开发） #

若无需跨平台支持，可直接将start脚本改为Windows命令：

"start": "ng serve --port 44455 --ssl --ssl-cert %APPDATA%\\ASP.NET\\https\\%npm_package_name%.pem --ssl-key %APPDATA%\\ASP.NET\\https\\%npm_package_name%.key"

以此排除run-script-os的潜在问题。

验证操作 #

每次修改后，关闭所有Visual Studio实例，重新打开项目并执行清理解决方案（Build -> Clean Solution），再启动项目验证效果。

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