# @azure/msal-common 中文文档

规范地址：https://npmcn.com/package/%40azure/msal-common/

版本：16\.16\.1
npm 元数据更新时间：2026-11-06T23:49:01.794Z
中文译文更新时间：2026-11-07T13:03:08.259Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40azure/msal-common
原文对照：https://npmcn.com/package/%40azure/msal-common/?lang=original
项目主页：https://github.com/AzureAD/microsoft-authentication-library-for-js#readme
源码仓库：https://github.com/AzureAD/microsoft-authentication-library-for-js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3 MB，690 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=0\.8\.0
- 运行依赖：0 个
- 首次发布：2020-01-18T00:46:14.341Z
- 最新版本发布：2026-11-06T23:49:01.612Z
- 近 30 天下载量：146746766（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：191（近 12 个月 44 个）

## 中文简介

Js 的 Microsoft 认证库

## 安装

```sh
npm install @azure/msal-common
```

也可以使用：`pnpm add @azure/msal-common`、`yarn add @azure/msal-common`、`bun add @azure/msal-common`

## README

# JavaScript (MSAL.js) 通用协议软件包的 Microsoft 认证库

[![npm version](https://img.shields.io/npm/v/@azure/msal-common.svg?style=flat)](https://www.npmjs.com/package/@azure/msal-common/) [![npm version](https://img.shields.io/npm/dm/@azure/msal-common.svg)](https://nodei.co/npm/@azure/msal-common/) [![codecov](https://codecov.io/gh/AzureAD/microsoft-authentication-library-for-js/branch/dev/graph/badge.svg?flag=msal-common)](https://codecov.io/gh/AzureAD/microsoft-authentication-library-for-js)

| [开始](https://docs.microsoft.com/azure/active-directory/develop/guidedsetups/active-directory-javascriptspa) | [AAD 文档](https://aka.ms/aaddevv2) | [图书馆参考文献](https://azuread.github.io/microsoft-authentication-library-for-js/ref/modules/_azure_msal_common.html) |
| --- | --- | --- |

1.  [关于](https://npmcn.com/package/%40azure/msal-common/#readme-about)
2.  [财务问题](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-common/FAQ.md)
3.  [更改日志](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-common/CHANGELOG.md)
4.  [释放](https://npmcn.com/package/%40azure/msal-common/#readme-releases)
5.  [先决条件和使用](https://npmcn.com/package/%40azure/msal-common/#readme-prerequisites-and-usage)
6.  [安装](https://npmcn.com/package/%40azure/msal-common/#readme-installation)
7.  [安全报告](https://npmcn.com/package/%40azure/msal-common/#readme-security-reporting)
8.  [许可证](https://npmcn.com/package/%40azure/msal-common/#readme-license)
9.  [行为守则](https://npmcn.com/package/%40azure/msal-common/#readme-we-value-and-adhere-to-the-microsoft-open-source-code-of-conduct)

## 关于

JavaScript 的 MSAL 库允许客户端JavaScript 应用程序认证用户使用 [阿苏雷AD](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-overview) 工作账户和学校账户(AAD),微软个人账户(MSA)以及Facebook,Google,LinkedIn,微软账户等社会身份供应商通过 [Azure AD B2C (英语)](https://docs.microsoft.com/en-us/azure/active-directory-b2c/active-directory-b2c-overview#identity-providers) 服务。 也能让您的应用程序获得访问的符号 [微软云](https://www.microsoft.com/enterprise) 诸如: [微软图形](https://graph.microsoft.io/)。 。 。 .

这个 `@azure/msal-common` 此文件夹中由代码描述的软件包是该软件包的共同依赖性 `@azure/msal-browser` 软件包(以及将来的msal-node软件包)。 要注意这是内部图书馆,经常会变动. **它本身并不是为了生产消费.**

## 财务问题

见 [这里](https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-common/FAQ.md)。 。 。 .

## 先决条件和使用

这个图书馆不是用来制作的。 请使用您正在开发的平台专用的这些软件包之一 :

-   [单页申请的MSAL(SPA)](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-browser)
-   [节点的MSAL.js](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-node)

## 安装

### 通过国家预防机制:

```
npm install @azure/msal-common
```

## 安全报告

如果你发现我们的图书馆或服务有安全问题,请报告 [安全性@ microsoft.com](mailto:secure@microsoft.com) 尽可能详细。 您的呈文可能有资格通过 [微软慷慨](http://aka.ms/bugbounty) 程序。 请不要将安全问题张贴到 GitHub 问题或任何其他公共网站。 我们收到消息后马上联系你 我们鼓励您通过访问了解安全事件何时发生 [此页面](https://technet.microsoft.com/en-us/security/dd252948) 并签署安全咨询警报.

## 许可证

版权 (c) 微软公司。 版权所有。 获得麻省理工学院许可证(License);

## 我们重视并遵守微软开放源码行为守则

该项目通过了 [Microsoft 开源行为守则](https://opensource.microsoft.com/codeofconduct/)。更多信息见 [《行为守则》](https://opensource.microsoft.com/codeofconduct/faq/) 或联系人 [打开码@ microsoft.com](mailto:opencode@microsoft.com) 并附上任何其他问题或评论.

## 常见问题

### @azure/msal-common 是什么？

Js 的 Microsoft 认证库

### 如何安装 @azure/msal-common？

在项目目录运行 npm install @azure/msal-common，或使用 pnpm add / yarn add / bun add。

### @azure/msal-common 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @azure/msal-common 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @azure/msal-common 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=0\.8\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @azure/msal-common 可以商用吗？

@azure/msal-common 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @azure/msal-common 的下载量有多少？

根据 npm 官方下载统计，@azure/msal-common 在 2026/10/08 – 2026/11/06 这 30 天内被下载 146,746,766 次，日均约 4,891,559 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @azure/msal-common 还在维护吗？

最新版本 16\.16\.1 发布于 2026/11/07（今天）；至今共发布 191 个版本，其中过去 12 个月发布了 44 个；首次发布于 2020/01/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。