npm私有作用域包通过@scope/package-name格式实现,默认私有,需登录对应账户、name字段含作用域、执行npm publish发布;安装和引用均需完整作用域名。

npm 通过 @scope/package-name 的格式支持私有作用域(scoped packages),这是实现私有命名空间包的核心机制。作用域本质上是一个命名前缀,用于将包组织到逻辑分组中,并默认设为私有(除非显式发布为公开)。
如何创建和使用私有作用域包
作用域名通常对应 npm 账户用户名或组织名,例如 @myorg 或 @johndoe。要发布私有作用域包,需满足以下条件:
- 已登录 npm 账户(
npm login),且作用域归属该账户或其所属组织 - 包的
name字段在package.json中必须以@scope/开头,如"name": "@myorg/utils" - 默认情况下,作用域包是私有的;若想公开,需在发布时加
--access public参数
发布私有作用域包的具体步骤
假设你要发布一个属于 @acme 作用域的工具包:
- 初始化项目:
npm init -y,然后手动修改package.json中的"name"为"@acme/logger" - 确保已登录对应账户:
npm login --scope=@acme(推荐指定 scope 登录,避免权限混淆) - 发布:
npm publish(默认私有)或npm publish --access=public(如需公开)
发布后,其他用户安装时需用完整作用域名:npm install @acme/logger。
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要:(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
组织作用域与权限管理
如果你使用的是 npm 组织(如 @mycompany),需注意:
- 只有组织管理员可创建新作用域包,成员需被授予
read、write或admin权限才能发布或访问 - 可通过
npm access命令管理权限,例如:npm access grant read-write @mycompany:my-team @mycompany/logger - 私有作用域包不会出现在公共 npm 搜索中,仅对授权用户可见
在项目中引用私有作用域包
安装后,在代码中直接导入即可,无需额外配置:
-
import { log } from '@acme/logger';(ESM) -
const { log } = require('@acme/logger');(CommonJS)
若在 CI/CD 或团队环境中使用,需确保执行 npm install 的机器已登录对应 npm 账户(可用 .npmrc 文件配置认证令牌)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










