初识 peerDependencies

目录

初步认识 peerDependencies

semver 介绍

# 摘要

# 简介

# 语义化版本控制规范(SemVer)

# 合法语义化版本的巴科斯范式语法

# 为什么要使用语义化的版本控制?

# FAQ

示例讲解:vue-router 插件

# 说明

声明

验证


初步认识 peerDependencies

在某些情况下,你想表达你的包与宿主工具或库的兼容性,而不一定要做这个宿主的 require。这通常被称为插件。值得注意的是,您的模块可能会暴露主机文档所期望和指定的特定接口。

例如:

{"name": "tea-latte","version": "1.3.5","peerDependencies": {"tea": "2.x"}
}

这确保您的包 tea-latte 只能与主机包 tea 的第二个主要版本一起安装。npm install tea-latte 可能会产生以下依赖关系图

├── tea-latte@1.3.5
└── tea@2.2.0

在 npm 版本 3 到 6 中,peerDependencies 不会自动安装,如果在树中发现无效版本的对等依赖项,则会发出警告。从 npm v7 开始,默认安装 peerDependencies。

如果无法正确解析树,则尝试安装另一个具有冲突要求的插件可能会导致错误。出于这个原因,请确保您的插件要求尽可能广泛,而不是将其锁定到特定的补丁版本。

假设主机符合 semver,只有主机包主要版本的更改会破坏您的插件。因此,如果您使用过每个 1.x 版本的主机包,请使用 "^1.0""1.x" 来表达这一点。如果您依赖 1.5.2 中引入的功能,请使用 "^1.5.2"

semver 介绍

# 摘要

版本格式:主版本号.次版本号.修订号,版本号递增规则如下:

  1. 主版本号:当你做了不兼容的 API 修改,
  2. 次版本号:当你做了向下兼容的功能性新增,
  3. 修订号:当你做了向下兼容的问题修正。

先行版本号及版本编译信息可以加到“主版本号.次版本号.修订号”的后面,作为延伸。

# 简介

在软件管理的领域里存在着被称作“依赖地狱”的死亡之谷,系统规模越大,加入的包越多,你就越有可能在未来的某一天发现自己已深陷绝望之中。

在依赖高的系统中发布新版本包可能很快会成为噩梦。如果依赖关系过高,可能面临版本控制被锁死的风险(必须对每一个依赖包改版才能完成某次升级)。而如果依赖关系过于松散,又将无法避免版本的混乱(假设兼容于未来的多个版本已超出了合理数量)。当你项目的进展因为版本依赖被锁死或版本混乱变得不够简便和可靠,就意味着你正处于依赖地狱之中。

作为这个问题的解决方案之一,我提议用一组简单的规则及条件来约束版本号的配置和增长。这些规则是根据(但不局限于)已经被各种封闭、开放源码软件所广泛使用的惯例所设计。为了让这套理论运作,你必须先有定义好的公共 API。这可能包括文档或代码的强制要求。无论如何,这套 API 的清楚明了是十分重要的。一旦你定义了公共 API,你就可以透过修改相应的版本号来向大家说明你的修改。考虑使用这样的版本号格式:X.Y.Z(主版本号.次版本号.修订号)修复问题但不影响 API 时,递增修订号;API 保持向下兼容的新增及修改时,递增次版本号;进行不向下兼容的修改时,递增主版本号。

我称这套系统为“语义化的版本控制”,在这套约定下,版本号及其更新方式包含了相邻版本间的底层代码和修改内容的信息。

# 语义化版本控制规范(SemVer)

以下关键词 MUST、MUST NOT、REQUIRED、SHALL、SHALL NOT、SHOULD、SHOULD NOT、 RECOMMENDED、MAY、OPTIONAL 依照 RFC 2119 的叙述解读。

  1. 使用语义化版本控制的软件必须(MUST)定义公共 API。该 API 可以在代码中被定义或出现于严谨的文档内。无论何种形式都应该力求精确且完整。
  2. 标准的版本号必须(MUST)采用 X.Y.Z 的格式,其中 X、Y 和 Z 为非负的整数,且禁止(MUST NOT)在数字前方补零。X 是主版本号、Y 是次版本号、而 Z 为修订号。每个元素必须(MUST)以数值来递增。例如:1.9.1 -> 1.10.0 -> 1.11.0。
  3. 标记版本号的软件发行后,禁止(MUST NOT)改变该版本软件的内容。任何修改都必须(MUST)以新版本发行。
  4. 主版本号为零(0.y.z)的软件处于开发初始阶段,一切都可能随时被改变。这样的公共 API 不应该被视为稳定版。
  5. 1.0.0 的版本号用于界定公共 API 的形成。这一版本之后所有的版本号更新都基于公共 API 及其修改内容。
  6. 修订号 Z(x.y.Z | x > 0)必须(MUST)在只做了向下兼容的修正时才递增。这里的修正指的是针对不正确结果而进行的内部修改。
  7. 次版本号 Y(x.Y.z | x > 0)必须(MUST)在有向下兼容的新功能出现时递增。在任何公共 API 的功能被标记为弃用时也必须(MUST)递增。也可以(MAY)在内部程序有大量新功能或改进被加入时递增,其中可以(MAY)包括修订级别的改变。每当次版本号递增时,修订号必须(MUST)归零。
  8. 主版本号 X(X.y.z | X > 0)必须(MUST)在有任何不兼容的修改被加入公共 API 时递增。其中可以(MAY)包括次版本号及修订级别的改变。每当主版本号递增时,次版本号和修订号必须(MUST)归零。
  9. 先行版本号可以(MAY)被标注在修订版之后,先加上一个连接号再加上一连串以句点分隔的标识符来修饰。标识符必须(MUST)由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成,且禁止(MUST NOT)留白。数字型的标识符禁止(MUST NOT)在前方补零。先行版的优先级低于相关联的标准版本。被标上先行版本号则表示这个版本并非稳定而且可能无法满足预期的兼容性需求。范例:1.0.0-alpha、1.0.0-alpha.1、1.0.0-0.3.7、1.0.0-x.7.z.92。
  10. 版本编译信息可以(MAY)被标注在修订版或先行版本号之后,先加上一个加号再加上一连串以句点分隔的标识符来修饰。标识符必须(MUST)由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成,且禁止(MUST NOT)留白。当判断版本的优先层级时,版本编译信息可(SHOULD)被忽略。因此当两个版本只有在版本编译信息有差别时,属于相同的优先层级。范例:1.0.0-alpha+001、1.0.0+20130313144700、1.0.0-beta+exp.sha.5114f85。
  11. 版本的优先层级指的是不同版本在排序时如何比较。

                1、判断优先层级时,必须(MUST)把版本依序拆分为主版本号、次版本号、修订号及先行版本号后进行比较(版本编译信息不在这份比较的列表中)。

                2、由左到右依序比较每个标识符,第一个差异值用来决定优先层级:主版本号、次版本号及修订号以数值比较。

                        例如:1.0.0 < 2.0.0 < 2.1.0 < 2.1.1。

                3、当主版本号、次版本号及修订号都相同时,改以优先层级比较低的先行版本号决定。

                        例如:1.0.0-alpha < 1.0.0。

                4、有相同主版本号、次版本号及修订号的两个先行版本号,其优先层级必须(MUST)透过由左到右的每个被句点分隔的标识符来比较,直到找到一个差异值后决定:

                        a. 只有数字的标识符以数值高低比较。

                        b. 有字母或连接号时则逐字以 ASCII 的排序来比较。

                        c. 数字的标识符比非数字的标识符优先层级低。

                        d. 若开头的标识符都相同时,栏位比较多的先行版本号优先层级比较高。

                        例如:1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 <                         1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0。

# 合法语义化版本的巴科斯范式语法

<valid semver> ::= <version core>| <version core> "-" <pre-release>| <version core> "+" <build>| <version core> "-" <pre-release> "+" <build><version core> ::= <major> "." <minor> "." <patch><major> ::= <numeric identifier><minor> ::= <numeric identifier><patch> ::= <numeric identifier><pre-release> ::= <dot-separated pre-release identifiers><dot-separated pre-release identifiers> ::= <pre-release identifier>| <pre-release identifier> "." <dot-separated pre-release identifiers><build> ::= <dot-separated build identifiers><dot-separated build identifiers> ::= <build identifier>| <build identifier> "." <dot-separated build identifiers><pre-release identifier> ::= <alphanumeric identifier>| <numeric identifier><build identifier> ::= <alphanumeric identifier>| <digits><alphanumeric identifier> ::= <non-digit>| <non-digit> <identifier characters>| <identifier characters> <non-digit>| <identifier characters> <non-digit> <identifier characters><numeric identifier> ::= "0"| <positive digit>| <positive digit> <digits><identifier characters> ::= <identifier character>| <identifier character> <identifier characters><identifier character> ::= <digit>| <non-digit><non-digit> ::= <letter>| "-"<digits> ::= <digit>| <digit> <digits><digit> ::= "0"| <positive digit><positive digit> ::= "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"<letter> ::= "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J"| "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" | "S" | "T"| "U" | "V" | "W" | "X" | "Y" | "Z" | "a" | "b" | "c" | "d"| "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n"| "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x"| "y" | "z"


# 为什么要使用语义化的版本控制?

这并不是一个新的或者革命性的想法。实际上,你可能已经在做一些近似的事情了。问题在于只是“近似”还不够。如果没有某个正式的规范可循,版本号对于依赖的管理并无实质意义。将上述的想法命名并给予清楚的定义,让你对软件使用者传达意向变得容易。一旦这些意向变得清楚,弹性(但又不会太弹性)的依赖规范就能达成。

举个简单的例子就可以展示语义化的版本控制如何让依赖地狱成为过去。假设有个名为“救火车”的函数库,它需要另一个名为“梯子”并已经有使用语义化版本控制的包。当救火车创建时,梯子的版本号为 3.1.0。因为救火车使用了一些版本 3.1.0 所新增的功能,你可以放心地指定依赖于梯子的版本号大于等于 3.1.0 但小于 4.0.0。这样,当梯子版本 3.1.1 和 3.2.0 发布时,你可以将直接它们纳入你的包管理系统,因为它们能与原有依赖的软件兼容。

作为一位负责任的开发者,你理当确保每次包升级的运作与版本号的表述一致。现实世界是复杂的,我们除了提高警觉外能做的不多。你所能做的就是让语义化的版本控制为你提供一个健全的方式来发行以及升级包,而无需推出新的依赖包,节省你的时间及烦恼。

如果你对此认同,希望立即开始使用语义化版本控制,你只需声明你的函数库正在使用它并遵循这些规则就可以了。请在你的 README 文件中保留此页链接,让别人也知道这些规则并从中受益。

# FAQ

在 0.y.z 初始开发阶段,我该如何进行版本控制?
最简单的做法是以 0.1.0 作为你的初始化开发版本,并在后续的每次发行时递增次版本号。

如何判断发布 1.0.0 版本的时机?
当你的软件被用于正式环境,它应该已经达到了 1.0.0 版。如果你已经有个稳定的 API 被使用者依赖,也会是 1.0.0 版。如果你很担心向下兼容的问题,也应该算是 1.0.0 版了。

这不会阻碍快速开发和迭代吗?
主版本号为零的时候就是为了做快速开发。如果你每天都在改变 API,那么你应该仍在主版本号为零的阶段(0.y.z),或是正在下个主版本的独立开发分支中。

对于公共 API,若即使是最小但不向下兼容的改变都需要产生新的主版本号,岂不是很快就达到 42.0.0 版?
这是开发的责任感和前瞻性的问题。不兼容的改变不应该轻易被加入到有许多依赖代码的软件中。升级所付出的代价可能是巨大的。要递增主版本号来发行不兼容的改版,意味着你必须为这些改变所带来的影响深思熟虑,并且评估所涉及的成本及效益比。

为整个公共 API 写文档太费事了!
为供他人使用的软件编写适当的文档,是你作为一名专业开发者应尽的职责。保持项目高效的一个非常重要的部分是掌控软件的复杂度,如果没有人知道如何使用你的软件或不知道哪些函数的调用是可靠的,要掌控复杂度会是困难的。长远来看,使用语义化版本控制以及对于公共 API 有良好规范的坚持,可以让每个人及每件事都运行顺畅。

万一不小心把一个不兼容的改版当成了次版本号发行了该怎么办?
一旦发现自己破坏了语义化版本控制的规范,就要修正这个问题,并发行一个新的次版本号来更正这个问题并且恢复向下兼容。即使是这种情况,也不能去修改已发行的版本。可以的话,将有问题的版本号记录到文档中,告诉使用者问题所在,让他们能够意识到这是有问题的版本。

如果我更新了自己的依赖但没有改变公共 API 该怎么办?
由于没有影响到公共 API,这可以被认定是兼容的。若某个软件和你的包有共同依赖,则它会有自己的依赖规范,作者也会告知可能的冲突。要判断改版是属于修订等级或是次版等级,是依据你更新的依赖关系是为了修复问题或是加入新功能。对于后者,我经常会预期伴随着更多的代码,这显然会是一个次版本号级别的递增。

如果我变更了公共 API 但无意中未遵循版本号的改动怎么办呢?(意即在修订等级的发布中,误将重大且不兼容的改变加到代码之中)
自行做最佳的判断。如果你有庞大的使用者群在依照公共 API 的意图而变更行为后会大受影响,那么最好做一次主版本的发布,即使严格来说这个修复仅是修订等级的发布。记住, 语义化的版本控制就是透过版本号的改变来传达意义。若这些改变对你的使用者是重要的,那就透过版本号来向他们说明。

我该如何处理即将弃用的功能?
弃用现存的功能是软件开发中的家常便饭,也通常是向前发展所必须的。当你弃用部分公共 API 时,你应该做两件事:(1)更新你的文档让使用者知道这个改变,(2)在适当的时机将弃用的功能透过新的次版本号发布。在新的主版本完全移除弃用功能前,至少要有一个次版本包含这个弃用信息,这样使用者才能平顺地转移到新版 API。

语义化版本对于版本的字符串长度是否有限制呢?
没有,请自行做适当的判断。举例来说,长到 255 个字符的版本已过度夸张。再者,特定的系统对于字符串长度可能会有他们自己的限制。

“v1.2.3” 是一个语义化版本号吗?
“v1.2.3” 并不是一个语义化的版本号。但是,在语义化版本号之前增加前缀 “v” 是用来表示版本号的常用做法。在版本控制系统中,将 “version” 缩写为 “v” 是很常见的。比如:git tag v1.2.3 -m "Release version 1.2.3" 中,“v1.2.3” 表示标签名称,而 “1.2.3” 是语义化版本号。

是否有推荐的正则表达式用以检查语义化版本号的正确性?
有两个推荐的正则表达式。第一个用于支持按组名称提取的语言(PCRE[Perl 兼容正则表达式,比如 Perl、PHP 和 R]、Python 和 Go)。

参见:https://regex101.com/r/Ly7O1x/3/

^(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$


第二个用于支持按编号提取的语言(与第一个对应的提取项按顺序分别为:major、minor、patch、prerelease、buildmetadata)。主要包括 ECMA Script(JavaScript)、PCRE(Perl 兼容正则表达式,比如 Perl、PHP 和 R)、Python 和 Go。 参见:https://regex101.com/r/vkijKf/1/

^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*

示例讲解:vue-router 插件

贴上vue-router插件的package.json代码,可以看到其中 peerDependencies 值为 {"vue": "^3.2.0"}

{"name": "vue-router","version": "4.3.2","main": "index.js","unpkg": "dist/vue-router.global.js","jsdelivr": "dist/vue-router.global.js","module": "dist/vue-router.mjs","types": "dist/vue-router.d.ts","exports": {"./auto-routes": {"types": "./vue-router-auto-routes.d.ts","node": {"import": {"production": "./dist/vue-router.node.mjs","development": "./dist/vue-router.node.mjs","default": "./dist/vue-router.node.mjs"},"require": {"production": "./dist/vue-router.prod.cjs","development": "./dist/vue-router.cjs","default": "./index.js"}},"import": "./dist/vue-router.mjs","require": "./index.js"},"./auto": {"types": "./vue-router-auto.d.ts","node": {"import": {"production": "./dist/vue-router.node.mjs","development": "./dist/vue-router.node.mjs","default": "./dist/vue-router.node.mjs"},"require": {"production": "./dist/vue-router.prod.cjs","development": "./dist/vue-router.cjs","default": "./index.js"}},"import": "./dist/vue-router.mjs","require": "./index.js"},".": {"types": "./dist/vue-router.d.ts","node": {"import": {"production": "./dist/vue-router.node.mjs","development": "./dist/vue-router.node.mjs","default": "./dist/vue-router.node.mjs"},"require": {"production": "./dist/vue-router.prod.cjs","development": "./dist/vue-router.cjs","default": "./index.js"}},"import": "./dist/vue-router.mjs","require": "./index.js"},"./dist/*": "./dist/*","./vetur/*": "./vetur/*","./package.json": "./package.json"},"sideEffects": false,"author": {"name": "Eduardo San Martin Morote","email": "posva13@gmail.com"},"funding": "https://github.com/sponsors/posva","license": "MIT","repository": {"type": "git","url": "git+https://github.com/vuejs/router.git"},"bugs": {"url": "https://github.com/vuejs/router/issues"},"homepage": "https://github.com/vuejs/router#readme","files": ["index.js","dist/*.{js,cjs,mjs}","dist/vue-router.d.ts","vue-router-auto.d.ts","vue-router-auto-routes.d.ts","vetur/tags.json","vetur/attributes.json","README.md"],"peerDependencies": {"vue": "^3.2.0"},"vetur": {"tags": "vetur/tags.json","attributes": "vetur/attributes.json"},"dependencies": {"@vue/devtools-api": "^6.5.1"},"devDependencies": {"@microsoft/api-extractor": "^7.40.1","@rollup/plugin-alias": "^5.1.0","@rollup/plugin-commonjs": "^25.0.7","@rollup/plugin-node-resolve": "^15.2.3","@rollup/plugin-replace": "^5.0.5","@rollup/plugin-terser": "^0.4.4","@sucrase/jest-plugin": "^3.0.0","@types/jest": "^29.5.12","@types/jsdom": "^21.1.6","@types/nightwatch": "^2.3.30","@vitejs/plugin-vue": "^5.0.4","@vue/compiler-sfc": "^3.4.23","@vue/server-renderer": "^3.4.23","@vue/test-utils": "^2.4.4","browserstack-local": "^1.5.5","chromedriver": "^121.0.2","connect-history-api-fallback": "^1.6.0","conventional-changelog-cli": "^2.1.1","dotenv": "^16.4.5","faked-promise": "^2.2.2","geckodriver": "^3.2.0","jest": "^29.7.0","jest-environment-jsdom": "^29.7.0","jest-mock-warn": "^1.1.0","nightwatch": "^2.6.22","nightwatch-helpers": "^1.2.0","rimraf": "^5.0.5","rollup": "^3.29.4","rollup-plugin-analyzer": "^4.0.0","rollup-plugin-typescript2": "^0.36.0","sucrase": "^3.34.0","typescript": "~5.3.3","vite": "^5.2.9","vue": "^3.4.23"},"scripts": {"dev": "jest --watch","changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 1","build": "rimraf dist && rollup -c rollup.config.mjs","build:dts": "api-extractor run --local --verbose && tail -n +10 src/globalExtensions.ts >> dist/vue-router.d.ts","build:playground": "vue-tsc --noEmit && vite build --config playground/vite.config.ts","build:e2e": "vue-tsc --noEmit && vite build --config e2e/vite.config.mjs","build:size": "pnpm run build && rollup -c size-checks/rollup.config.mjs","dev:e2e": "vite --config e2e/vite.config.mjs","test:types": "tsc --build tsconfig.json","test:dts": "tsc -p ./test-dts/tsconfig.json","test:unit": "jest --coverage","test": "pnpm run test:types && pnpm run test:unit && pnpm run build && pnpm run build:dts && pnpm run test:e2e","test:e2e": "pnpm run test:e2e:headless","test:e2e:headless": "node e2e/runner.mjs --env chrome-headless","test:e2e:native": "node e2e/runner.mjs --env chrome","test:e2e:ci": "node e2e/runner.mjs --env chrome-headless --retries 2","test:e2e:bs": "node e2e/runner.mjs --local -e android5 --tag browserstack","test:e2e:bs-test": "node e2e/runner.mjs --local --env browserstack.local_chrome --tag browserstack"}
}

# 说明

vue-router在开发过程中依赖于vue包,但是又不希望将这个依赖关系包含在自己的发布版本中时,就可以使用 peerDependencies(同行依赖)。

让我更详细地解释一下 peerDependencies 的概念和用法:

1. 什么是 peerDependencies?

peerDependencies 是指一个软件包在运行时所需的依赖项,但是它希望这些依赖项由使用它的其他软件包提供,而不是自己将这些依赖项包含在自己的发布版本中。

2. 为什么使用 peerDependencies?

使用 peerDependencies 的主要目的是为了避免在一个项目中出现依赖项的重复版本。当一个软件包同时依赖于另一个软件包,并且两者都在自己的发布版本中包含了相同版本的依赖项时,这可能会导致冲突和版本不一致的问题。

通过将依赖项声明为 peerDependencies,软件包作者可以明确指定它的运行时依赖应该由使用它的其他软件包提供,从而确保所有使用者都使用同一版本的依赖项,避免了版本冲突和不一致的问题。

3. 如何声明 peerDependencies?

要声明 peerDependencies,您可以将依赖项添加到您的软件包的 package.json 文件中的 peerDependencies 字段中,例如:

{"name": "your-package","peerDependencies": {"dependency-name": "^1.0.0"}
}

在上面的示例中,dependency-name 是您的软件包在运行时所需的同行依赖项的名称,^1.0.0 表示您的软件包兼容的依赖项的版本范围。

4. 使用 peerDependencies 的注意事项:

  • 使用者需要手动安装 peerDependencies。在使用您的软件包时,使用者需要确保安装了您声明的 peerDependencies。通常,npm 和 Yarn 在安装软件包时会自动安装相应的 peerDependencies,但是如果使用者手动管理依赖项或者使用其他包管理工具,则可能需要手动安装。
  • 确保对peerDependencies 的正确使用。在声明 peerDependencies 时,需要确保使用者确实能够提供所需的依赖项。通常情况下,应该将 peerDependencies 声明为您的软件包所需要的最小版本,以确保与使用者的兼容性。
  • 避免滥用 peerDependencies。尽管 peerDependencies 可以解决依赖项重复版本的问题,但是滥用会导致依赖项的管理变得复杂,并且可能会造成一些意想不到的问题。因此,在声明 peerDependencies 时应该谨慎选择,并且仅在确实需要时使用。

总的来说,peerDependencies 是一种在软件包开发中管理依赖项的重要机制,可以帮助开发者避免版本冲突和不一致的问题,同时提高了软件包的灵活性和可重用性。

声明

要在您的项目中声明对 vue 3.4.27 版本的 peerDependencies,您可以通过以下步骤完成:

1. 编辑 package.json:

打开您的项目的 package.json 文件,并添加或更新 peerDependencies 字段,如下所示:

{"name": "your-project","version": "1.0.0","peerDependencies": {"vue": "^3.4.27"}
}


2. 安装 Vue:

然后,在您的项目中安装 Vue,确保安装的版本符合您在 peerDependencies 中声明的范围。您可以运行以下命令:

npm install vue@3.4.27 --save-peer

或者,如果您使用的是 Yarn:

yarn add vue@3.4.27 --peer


3. 更新依赖:

安装 Vue 后,您可能需要运行 npm installyarn 命令来更新您的项目的依赖项。

4. 验证配置:

最后,您可以确保 package.json 中的 peerDependencies 部分以及您安装的 Vue 版本符合预期。您可以通过查看 package.json 文件和运行 npm list vueyarn list vue 命令来验证。

这样,您的项目就声明了对 Vue 3.4.27 版本的 peerDependencies。任何使用您的项目的其他软件包都应该在运行时提供符合这个版本要求的 Vue。

验证

这里我随意打开了一个之前项目,查看了vue的同行依赖关系

PS D:\vinca\web> npm list vue
nuxt-app@2.0LTS D:\vinca\web   
├─┬ @chenfengyuan/vue-qrcode@2.0.0-rc.1
│ └── vue@3.4.21 deduped
├─┬ @element-plus/icons-vue@2.3.1      
│ └── vue@3.4.21 deduped
├─┬ @nuxtjs/seo@2.0.0-rc.10
│ └─┬ nuxt-link-checker@3.0.0-rc.7     
│   ├─┬ @vueuse/core@10.9.0
│   │ ├─┬ @vueuse/shared@10.9.0        
│   │ │ └─┬ vue-demi@0.14.7
│   │ │   └── vue@3.4.21 deduped       
│   │ └─┬ vue-demi@0.14.7
│   │   └── vue@3.4.21 deduped
│   ├─┬ floating-vue@5.2.0
│   │ └── vue@3.4.21 deduped
│   ├─┬ nuxt-site-config-kit@2.2.7
│   │ └─┬ site-config-stack@2.2.7
│   │   └── vue@3.4.21 deduped
│   └─┬ nuxt-site-config@2.2.7
│     └─┬ site-config-stack@2.2.7
│       └── vue@3.4.21 deduped
├─┬ @nuxtjs/sitemap@5.1.4
│ ├─┬ @nuxt/devtools-ui-kit@1.1.5
│ │ ├─┬ @vueuse/core@10.9.0
│ │ │ └─┬ vue-demi@0.14.7
│ │ │   └── vue@3.4.21 deduped
│ │ ├─┬ @vueuse/integrations@10.9.0
│ │ │ └─┬ vue-demi@0.14.7
│ │ │   └── vue@3.4.21 deduped
│ │ └─┬ @vueuse/nuxt@10.9.0
│ │   └─┬ vue-demi@0.14.7
│ │     └── vue@3.4.21 deduped
│ ├─┬ @vueuse/core@10.9.0
│ │ └─┬ vue-demi@0.14.7
│ │   └── vue@3.4.21 deduped
│ ├─┬ floating-vue@5.2.2
│ │ ├─┬ vue-resize@2.0.0-alpha.1
│ │ │ └── vue@3.4.21 deduped
│ │ └── vue@3.4.21 deduped
│ └─┬ site-config-stack@2.2.12
│   └── vue@3.4.21 deduped
├─┬ element-plus@2.6.3
│ ├─┬ @vueuse/core@9.13.0
│ │ ├─┬ @vueuse/shared@9.13.0
│ │ │ └─┬ vue-demi@0.14.7
│ │ │   └── vue@3.4.21 deduped
│ │ └─┬ vue-demi@0.14.7
│ │   └── vue@3.4.21 deduped
│ └── vue@3.4.21 deduped
├─┬ nuxt-og-image@3.0.0-rc.53
│ ├─┬ @vueuse/core@10.9.0
│ │ └─┬ vue-demi@0.14.7
│ │   └── vue@3.4.21 deduped
│ ├─┬ json-editor-vue@0.15.1
│ │ └── vue@3.4.21 deduped
│ └─┬ nuxt-icon@0.6.10
│   └─┬ @iconify/vue@4.1.1
│     └── vue@3.4.21 deduped
├─┬ nuxt-svgo@4.0.0
│ └── vue@3.4.21 deduped
├─┬ nuxt@3.10.3
│ ├─┬ @nuxt/devtools@1.1.5
│ │ ├─┬ @vue/devtools-applet@7.0.27
│ │ │ ├─┬ @vue/devtools-ui@7.0.27
│ │ │ │ ├─┬ @vueuse/components@10.9.0
│ │ │ │ │ └─┬ vue-demi@0.14.7
│ │ │ │ │   └── vue@3.4.21 deduped
│ │ │ │ ├─┬ @vueuse/core@10.9.0
│ │ │ │ │ ├─┬ @vueuse/shared@10.9.0
│ │ │ │ │ │ └─┬ vue-demi@0.14.7
│ │ │ │ │ │   └── vue@3.4.21 deduped
│ │ │ │ │ └─┬ vue-demi@0.14.7
│ │ │ │ │   └── vue@3.4.21 deduped
│ │ │ │ └── vue@3.4.21 deduped
│ │ │ ├─┬ vue-virtual-scroller@2.0.0-beta.8
│ │ │ │ ├─┬ vue-observe-visibility@2.0.0-alpha.1
│ │ │ │ │ └── vue@3.4.21 deduped
│ │ │ │ └── vue@3.4.21 deduped
│ │ │ └── vue@3.4.21 deduped
│ │ └─┬ @vue/devtools-kit@7.0.27
│ │   └── vue@3.4.21 deduped
│ ├─┬ @nuxt/vite-builder@3.10.3
│ │ ├─┬ @vitejs/plugin-vue-jsx@3.1.0
│ │ │ └── vue@3.4.21 deduped
│ │ ├─┬ @vitejs/plugin-vue@5.0.4
│ │ │ └── vue@3.4.21 deduped
│ │ └── vue@3.4.21 deduped
│ ├─┬ @unhead/vue@1.8.18
│ │ └── vue@3.4.21 deduped
│ ├─┬ unplugin-vue-router@0.7.0
│ │ └─┬ @vue-macros/common@1.10.1
│ │   └── vue@3.4.21 deduped
│ └── vue@3.4.21 deduped
├─┬ pinia@2.1.7
│ ├─┬ vue-demi@0.14.7
│ │ └── vue@3.4.21 deduped
│ └── vue@3.4.21 deduped
├─┬ vue-router@4.3.0
│ └── vue@3.4.21 deduped
└─┬ vue@3.4.21└─┬ @vue/server-renderer@3.4.21└── vue@3.4.21 deduped

在 npm 的依赖关系图中,deduped 表示已经被去重了。这意味着在整个依赖树中,有两个或多个依赖项指向了同一个版本的软件包。当 npm 发现这种情况时,它会去除重复的依赖项,只保留一个,并在其他依赖项中引用这个已去重的依赖项。

这种去重机制有助于减少依赖项的重复,减小项目的体积,同时确保所有依赖项都使用同一版本的软件包,从而避免版本冲突和其他问题。


本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/bicheng/22722.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

在Windows11系统上搭建SFTP服务器

利用OpenSSH搭建SFTP服务器 下载安装部署OpenSSH创建一个测试账户测试链接为SFTP用户配置根目录下载安装部署OpenSSH 参考链接 部署完启动服务要使用管理员模式。 net start sshd创建一个测试账户 使用PC的微软账户是访问不了SFTP的。 需要使用被微软账户覆盖掉的系统账户和…

微信自定义小程序源码系统 众多组件随心搭 各行各业都适用的小程序 带完整的安装代码包以及搭建教程

系统概述 微信自定义小程序源码系统是一款基于微信官方开发框架进行深度定制的源码系统。该系统整合了众多优质组件&#xff0c;通过可视化的拖拽式操作&#xff0c;让开发者无需编写复杂的代码&#xff0c;即可快速搭建出符合自己需求的小程序。同时&#xff0c;该系统支持多…

iTerm2 携手 OpenAI,带来命令行的自然语言革新

在技术不断进步的今天&#xff0c;命令行工具的智能化已成为提升效率的关键。iTerm2&#xff0c;macOS 系统上广受欢迎的开源终端工具&#xff0c;通过最新版本 v3.5 的发布&#xff0c;实现了与 OpenAI 的集成&#xff0c;引领了这一变革。 iTerm2 简介 iTerm2 是一款功能强…

qcom 平台系统签名流程

security boot 平台的东东&#xff0c;oem 可定制的功能有限&#xff0c;只能参考平台文档&#xff0c;可以在高通的网站上搜索&#xff1a;Secure Boot Enablement&#xff0c;然后找对应平台的文档xxx-Secure Boot Enablement User Guide, step by step 操作即可 开机校验流…

CodeBlocks官方主题颜色更换及方法

文章目录 一、前言二 、用工具导入配置文件2.1 运行 cb_share_config.exe文件2.2 替换文件2.3 设置主题 三、配置主题3.1 步骤13.2 步骤23.3 步骤3 四、设置光标4.1 配置字体4.2 展示 行号 五、设置左边行号区域部分六、设置完后的效果七、下载地址 一、前言 Codeblocks 默认的…

【Python系列】Python装饰器

&#x1f49d;&#x1f49d;&#x1f49d;欢迎来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里可以感受到一份轻松愉快的氛围&#xff0c;不仅可以获得有趣的内容和知识&#xff0c;也可以畅所欲言、分享您的想法和见解。 推荐:kwan 的首页,持续学…

【数据结构】图论中求最短路径——迪杰斯特拉算法(Dijkstra)、弗洛伊德算法(Floyd)

目录 最短路径 (*)迪杰斯特拉算法&#xff08;Dijkstra&#xff09;迪杰斯特拉算法&#xff08;Dijkstra&#xff09;的算法原理&#xff1a; 弗洛伊德算法&#xff08;Floyd&#xff09;弗洛伊德算法&#xff08;Floyd&#xff09;的算法原理&#xff1a;弗洛伊德算法的&#…

哪种价格行为指标对投资者有用?AnzoCapital昂首资本总结6个特征

各位投资者都知道价格行为指标对于交易极具助益&#xff0c;无论是初学者还是专业交易员都能运用。构建外汇交易系统时&#xff0c;这类指标堪称核心且必不可少的工具。 但不是所有的价格行为指标都对投资者有用的&#xff0c;哪种价格行为指标才是对投资者有用的&#xff0c;都…

CogVLM2多模态开源大模型部署与使用

CogVLM2多模态开源大模型部署与使用 项目简介 CogVLM2 是由清华大学团队发布的新一代开源模型系列。2024年5月24日&#xff0c;发布了Int4版本模型&#xff0c;只需16GB显存即可进行推理。2024年5月20日&#xff0c;发布了基于llama3-8b的CogVLM2&#xff0c;性能与GPT-4V相当…

论文AI率过高?掌握这四种技巧轻松降重

随着人工智能技术的突飞猛进&#xff0c;AI生成内容&#xff08;AIGC&#xff09;已被广泛用于学术论文撰写中&#xff0c;提高效率同时也带来了原创性的挑战。面对日益严格的学术审查&#xff0c;一个突出的问题是&#xff1a;使用AI代写的论文能否通过内容检测&#xff1f;因…

Linux 搭建 ZeroTier 的 Moon 服务器

系统&#xff1a;centos 7.6 轻量云服务器&#xff1a;腾讯云 Moon是什么&#xff0c;为什么需要Moon&#xff1f; ZeroTier通过自己的多个根服务器帮助我们建立虚拟的局域网&#xff0c;让虚拟局域网内的各台设备可以打洞直连。这些根服务器的功能有些类似于通过域名查询找到…

SpringCloud Hystrix服务熔断实例总结

SpringCloud Hystrix断路器-服务熔断与降级和HystrixDashboard SpringCloud Hystrix服务降级实例总结 【1】服务熔断 熔断机制概述 熔断机制是应对雪崩效应的一种微服务链路保护机制。当扇出链路的某个微服务出错不可用或者响应时间太长时&#xff0c;会进行服务的降级&…

WWDC 2024前瞻:苹果如何用AI技术重塑iOS 18和Siri

苹果下周的全球开发者大会有望成为这家 iPhone 制造商历史上的关键时刻。在 WWDC 上&#xff0c;这家库比蒂诺科技巨头将展示如何选择将人工智能技术集成到其设备和软件中&#xff0c;包括通过与 OpenAI 的历史性合作伙伴关系。随着重大事件的临近&#xff0c;有关 iOS 18 及其…

AI大模型时代必须关注的数据库 DuckDB1.0 正式发布

开源数据库DuckDB1.0 经过内部6年的打磨&#xff0c;积累了30万行代码&#xff0c;1.8万star&#xff0c;2024.06.03号正式发布了1.0版本&#xff08;代号 Snow Duck&#xff09;。 我们新一代程序员&#xff0c;没能见证MySQL 1.0、PostgreSQL 1.0、Windows 1.0、Linux 1.0、…

flinksql 回撤流中主键发生变更的影响(group by中的值发生改变)

flinksql 回撤流中,主键发生变更的影响 1 什么是回撤流2 主键变更场景2.2 实践发生3 实践中发现的比较好的的实时数仓架构1 什么是回撤流 这篇文章主要谈论一个场景,简单来说: 首先我们来简单的说一下什么是回撤流,以及回撤流的底层原理,举个例子: 这个说的不是很清晰…

【吊打面试官系列】MySQL 中有哪几种锁?

大家好&#xff0c;我是锋哥。今天分享关于 【MySQL 中有哪几种锁&#xff1f;】面试题&#xff0c;希望对大家有帮助&#xff1b; MySQL 中有哪几种锁&#xff1f; 1、表级锁&#xff1a;开销小&#xff0c;加锁快&#xff1b;不会出现死锁&#xff1b;锁定粒度大&#xff0c;…

TypeScript学习(一):开发环境搭建

官方文档搭建参考 https://learn.microsoft.com/zh-cn/training/modules/typescript-get-started/ 1.下载node.js https://nodejs.org/en/download 2.下载vscode https://code.visualstudio.com/ 3.在线ts的测试工具 https://www.typescriptlang.org/play/ 4.下载typescr…

H5即时通讯群聊源码无限建群创群/H5聊天系统聊天网站源码/H5语音聊天系统

源码介绍 支持自助建群 管理群 修改群资料支持自动登录 登陆成功可自助修改资料后台可查看群组聊天消息记录支持表情 动态表情 图片发布支持消息语音提醒

docker-compose教程

1. docker-compose是什么&#xff1f; 1. 1 简介 compose、machine 和 swarm 是docker 原生提供的三大编排工具。 简称docker三剑客。Compose 项目是 Docker 官方的开源项目&#xff0c;定义和运行多个 Docker 容器的应用&#xff08;Defining and running multi-container Do…

月入30000的软件测试人员,简历是什么样子的?

我们都知道&#xff0c;简历是一个人进入职场的敲门砖。从某种层面来说&#xff0c;简历也像一个人的具象身份证&#xff0c;或者专业资格证。所以&#xff0c;一份简历的好坏&#xff0c;不仅关乎个人的“脸面”&#xff0c;更关乎你是不是一个有“含金量”的技术人员。 所以…