Taze 依赖更新

简介

Taze 是一个用于检测项目依赖更新的命令行工具，支持多种版本检查模式，可以在不修改 package.json 的前提下列出所有可更新的依赖，也可以交互式选择后批量写入。

相较于 npm outdated，Taze 的优势在于支持按语义化版本区间（major / minor / patch）筛选、交互式勾选、递归检测 monorepo 子包，并且可以规避「刚发布的不稳定版本」——通过 --maturity-period 设定等待天数。

安装

# 全局安装
npm install -g taze

# 或使用 npx 直接运行（无需安装）
npx taze

检查模式

命令	说明
`taze`	默认模式，检查版本范围内的更新
`taze major`	检查主版本更新
`taze minor`	检查次版本更新
`taze patch`	检查补丁版本更新
`taze latest`	检查最新版本
`taze newest`	检查最新稳定版本
`taze next`	检查下一个版本（含预发布版本）

常用选项

选项	说明
`-w, --write`	将更新写入 `package.json`
`-i, --install`	更新版本号后直接安装
`-u, --update`	更新版本号后直接升级
`-I, --interactive`	交互式模式，可选择性更新
`-a, --all`	显示所有包的最新信息
`-f, --force`	强制从服务器获取，绕过缓存
`-r, --recursive`	递归搜索子目录的 `package.json`
`-g, --global`	更新全局包
`-l, --include-locked`	包含锁定的依赖
`--peer`	包含 `peerDependencies`
`--timediff`	显示版本之间的时间差
`--nodecompat`	显示与当前 Node 版本的兼容性
`--maturity-period [days]`	等待新包发布的天数，默认 `7`
`--sort <type>`	排序方式，见下方说明
`--group`	按来源分组显示依赖
`--include <deps>`	只检查指定的依赖
`--exclude <deps>`	排除指定的依赖
`--cwd <path>`	指定工作目录
`--loglevel <level>`	日志级别：`debug` / `info` / `warn` / `error` / `silent`
`--fail-on-outdated`	发现过期依赖时以退出码 `1` 退出
`--ignore-paths <paths>`	忽略搜索 `package.json` 的路径
`--ignore-other-workspaces`	忽略其他工作区的 `package.json`
`--concurrency <requests>`	解析依赖时的并发请求数，默认 `10`

--sort 可选值：time-asc / time-desc / diff-asc / diff-desc / name-asc / name-desc。

使用示例

基础检测

# 默认检测
taze

# 检查主版本更新
taze major

# 检查次版本更新
taze minor

# 检查最新版本
taze latest

交互式更新

# 交互式选择更新（推荐）
taze -I

自动更新

# 检测并写入 package.json
taze -w

# 检测后直接安装
taze -i

# 检测后直接升级
taze -u

高级用法

# 显示所有包的详细信息
taze -a

# 强制刷新缓存后检测
taze -f

# 递归检测子目录（monorepo）
taze -r

# 更新全局包
taze -g

# 显示版本时间差
taze --timediff

# 检查 Node 版本兼容性
taze --nodecompat

# 包含锁定的依赖
taze -l

# 包含 peerDependencies
taze --peer

# 等待新包发布 7 天后再升级
taze --maturity-period 7

# 按名称排序
taze --sort name-asc

# 只检查特定依赖
taze --include react,vue

# 排除特定依赖
taze --exclude typescript

# 发现过期依赖时返回错误码（适用于 CI）
taze --fail-on-outdated

注意事项

更新前建议先提交当前代码，便于出现问题时回滚。
主版本更新可能包含破坏性变更，需谨慎处理，可先用 taze major 单独查看影响范围。
优先使用 -I 交互式模式选择性更新，比全量 -w 更安全。
在 CI/CD 中可使用 --fail-on-outdated 检测依赖是否过期，作为流水线卡点。
使用 --maturity-period 可避免立即升级到刚发布的版本，降低踩坑风险。

#Taze 依赖更新

#简介

#安装

#检查模式

#常用选项

#使用示例

#基础检测

#交互式更新

#自动更新

#高级用法

#注意事项

#相关链接