Skip to main content

​
基本用法

terminal

​
CLI 用法

terminal

​
通用信息

​
--help
boolean
打印此帮助菜单。别名：-h

​
配置

​
--config
string
指定配置文件路径（bunfig.toml）。别名：-c

​
Package.json 交互

​
--no-save
boolean
不更新 package.json 或不保存 lockfile
​
--save
boolean
default:"true"
保存到 package.json（默认为 true）
​
--trust
boolean
添加到项目 package.json 的 trustedDependencies 中并安装该包

​
Lockfile 行为

​
--yarn
boolean
写入 yarn.lock 文件（yarn v1）。别名：-y
​
--frozen-lockfile
boolean
禁止更改 lockfile
​
--save-text-lockfile
boolean
保存基于文本的 lockfile
​
--lockfile-only
boolean
仅生成 lockfile，不安装依赖

​
依赖过滤

​
--production
boolean
不安装 devDependencies。别名：-p
​
--omit
string
从安装中排除 dev、optional 或 peer 依赖

​
网络与注册表

​
--ca
string
提供证书颁发机构签名证书
​
--cafile
string
与 —ca 相同，但指定证书的文件路径
​
--registry
string
使用特定注册表，覆盖 .npmrc、bunfig.toml 和环境变量

​
执行控制与验证

​
--dry-run
boolean
不实际安装任何内容
​
--force
boolean
始终从注册表请求最新版本并重新安装所有依赖。别名：-f
​
--no-verify
boolean
跳过验证新下载包的完整性

​
输出与日志

​
--silent
boolean
不输出任何日志
​
--verbose
boolean
极度详细的日志输出
​
--no-progress
boolean
禁用进度条
​
--no-summary
boolean
不打印摘要

​
缓存

​
--cache-dir
string
从特定目录路径存储和加载缓存数据
​
--no-cache
boolean
完全忽略清单缓存

​
脚本执行

​
--ignore-scripts
boolean
跳过项目 package.json 中的生命周期脚本（依赖的脚本从不运行）
​
--concurrent-scripts
number
生命周期脚本的最大并发作业数（默认：2 倍 CPU 核心数）

​
范围与路径

​
--global
boolean
全局安装。别名：-g
​
--cwd
string
设置特定的 cwd

​
高级与性能

​
--backend
string
default:"clonefile"
安装依赖的特定平台优化。可能的值：clonefile（默认）、hardlink、symlink、copyfile
​
--network-concurrency
number
default:"48"
最大并发网络请求数（默认 48）