Node ​

ni ​

ni - use the right package manager.

$ npm i -g @antfu/ni

npm · yarn · pnpm · bun

ni - install ​

ni

# npm install
# yarn install
# pnpm install
# bun install

nun @types/node

# npm uninstall @types/node
# yarn remove @types/node
# pnpm remove @types/node

ni vite

# npm install vite
# yarn add vite
# pnpm add vite

ni @types/node -D

# npm i -D @types/node
# yarn add -D @types/node
# pnpm add -D @types/node

ni -g eslint

# npm install -g eslint
# yarn add global eslint
# pnpm add eslint -g

ni --frozen / nci

# npm ci
# yarn install --frozen-lockfile (Yarn 1)
# yarn install --immutable (Yarn Berry)
# pnpm install --frozen-lockfile
# bun install --no-save


nu

# (not available for bun)
# npm upgrade
# yarn upgrade (Yarn 1)
# yarn up (Yarn Berry)
# pnpm update

nu -i

# (not available for npm & bun)
# yarn upgrade-interactive (Yarn 1)
# yarn up -i (Yarn Berry)
# pnpm update -i

nr - run ​

nr dev --port=3000

# npm run dev --port=3000
# yarn run dev --port=3000
# pnpm run dev --port=3000
# bun run dev --port=3000

nr
# interactively select the script to run

nr -
# rerun the last command

Config ​

; ~/.nirc
; fallback when no lock found
defaultAgent=npm # default "prompt"
; for global installs
globalAgent=npm

# ~/.bashrc
# custom configuration file path
export NI_CONFIG_FILE="$HOME/.config/ni/nirc"

volta ​

$ curl https://get.volta.sh | bash

$ brew install volta

然后，添加 volta 到环境变量：

source .bash_profile

之后，你就可以正常使用 volta

$ volta

Volta 1.1.1
The JavaScript Launcher ⚡

    To install a tool in your toolchain, use `volta install`.
    To pin your project's runtime or package manager, use `volta pin`.

USAGE:
    volta [FLAGS] [SUBCOMMAND]

FLAGS:
        --verbose    Enables verbose diagnostics
        --quiet      Prevents unnecessary output
    -v, --version    Prints the current version of Volta
    -h, --help       Prints help information

SUBCOMMANDS:
    fetch          Fetches a tool to the local machine
    install        Installs a tool in your toolchain
    uninstall      Uninstalls a tool from your toolchain
    pin            Pins your project's runtime or package manager
    list           Displays the current toolchain
    completions    Generates Volta completions
    which          Locates the actual binary that will be called by Volta
    setup          Enables Volta for the current user / shell
    run            Run a command with custom Node, npm, pnpm, and/or Yarn versions

success: pinned node@16.19.1 (with npm@8.19.3) in package.json

"volta": {
  "node": "16.19.1"
}

⚡️ Currently active tools:

    Node: v16.19.1 (current @ /Users/xuhao/Downloads/front-end/vitepress/vitepress-blog/
    package.json)
    Yarn: v4.0.0-rc.39 (default)
    Tool binaries available:
        nrm (default)
        pnpm, pnpx (default)
        rimraf (current @ /Users/xuhao/Downloads/front-end/vitepress/vitepress-blog/
    package.json)
        yrm (default)

See options for more detailed reports by running `volta list --help`.

nvm ​

# 查看远程服务器上所有的可用版本
nvm ls available

nvm current

nvm install 18.15.0

nvm use 18.15.0

nvm ls

npm ​

Common commands ​

# 查看全局安装的模块
$ npm ls -g --depth 0

# 查看全局安装的模块的详细信息
# (name, description, version number, github address, official website.)
$ npm ls -l -g --depth 0

# 强制固定版本号(--save-extra)
$ npm install dayjs -E

# 安装到 `dependencies` 中(--save)
$ npm i dayjs -S

# 安装到 `devDependencies` 中(--dev)
$ npm i dayjs -D

# 查看 `npm` 配置
$ npm config list

# 查看 `npm` 全部配置
$ npm config ls -l

# 查看脚本安装目录
$ where node

Commonly used npm packages ​

├── @adams549659584/nrm@1.2.6
├── @antfu/ni@0.21.3
├── @vue/cli@5.0.8
├── corepack@0.15.1
├── degit@2.8.4
├── npm@8.19.3
├── nrm@1.2.5
├── pnpm@8.6.0
├── prettier@3.0.0
├── rimraf@5.0.0
├── typescript@5.0.2
├── vue@3.3.4
└── yarn@1.22.19

peerDependencies ​

A peer dependency is a specific version or set of versions of a third-party software library that a module is designed to work with. They’re similar in concept to the relationship between a browser extension and a browser.

避免 核心依赖库 依赖的 模块 被重复下载的问题，扁平化依赖图。

• 如果用户显式依赖了核心库，则可以忽略各插件的 peerDependencies 声明；
• 如果用户没有显式依赖核心库，则按照插件 peerDependencies 中声明的版本将库安装到项目根目录中；
• 当用户依赖的版本、各插件依赖的版本之间不相互兼容，会报错让用户自行修复。

--legacy-peer-deps ​

在 npm v7 中，会默认安装 peerDependencies 。然而在很多情况下，这会导致版本冲突，从而中断安装过程。

–legacy-peer-deps 标志是在 v7 中引入的，目的是绕过 peerDependency 自动安装；它告诉 npm 忽略项目中引入的各个 modules 之间的相同 modules 但不同版本的问题并继续安装，保证各个引入的依赖之间对自身所使用的不同版本 modules 共存。

npm 的 --legacy-peer-deps 命令是用于在安装依赖包时启用旧版对等依赖解析算法的选项。

在 npm 7 中，对等依赖解析算法发生了变化，它会忽略与实际依赖不兼容的依赖项。这可能会导致安装失败或不兼容的依赖项被安装。为了解决这个问题，--legacy-peer-deps 选项被引入，它允许使用旧版对等依赖解析算法，以避免安装中断或不兼容的依赖项。

可以通过以下命令启用 --legacy-peer-deps 选项：

$ npm install --legacy-peer-deps

除此之外，还可以在 npm 配置文件中设置该选项，以使其在所有安装命令中自动启用：

$ npm config set legacy-peer-deps true

如果您想 --legacy-peer-deps 默认为所有 npm 安装设置标志，则可以考虑更新 .npmrc 文件。

legacy-peer-deps=true

需要注意的是，--legacy-peer-deps 它会告诉 npm 完全忽略对等依赖性。从长远来看，这会增加你的依赖解析。

--force ​

--force 命令是指忽略所有警告强制安装包，这样做可能会造成不可预测的后果，往往用于解决某些包在安装时出现的问题。

通常，我们希望使用该 --force 标志，因为这会告诉 npm 在发现冲突的依赖项时尝试设置不同的对等依赖项。

使用 force 仍然不是那么好，因为它会在你的 node_modules 文件夹中占用更多的磁盘空间——例如获取不同的版本并将它们存储在本地！

查看设备信息 ​

npx envinfo --system --binaries --browsers

# System:
#   OS: Windows 10 10.0.19044
#   CPU: (12) x64 Intel(R) Core(TM) i5-10400 CPU @ 2.90GHz
#   Memory: 1.13 GB / 7.89 GB
# Binaries:
#   Node: 16.19.0 - C:\Program Files\nodejs\node.EXE
#   Yarn: 1.22.19 - C:\Program Files\nodejs\yarn.CMD
#   npm: 8.19.3 - C:\Program Files\nodejs\npm.CMD
# Browsers:
#   Edge: Spartan (44.19041.1266.0), Chromium (111.0.1661.41)
#   Internet Explorer: 11.0.19041.1202

windows cmd alias ​

创建脚本文件 ​

目录：C:\Users\admin\cmd_alias.bat

@REM GIT
@doskey ph=git push
@doskey fe=git fetch
@doskey pl=git pull
@doskey ga=git add .
@doskey gc=git commit -m
@doskey gbd=git branch -d
@doskey gbD=git branch -D
@doskey gbdr=git branch -dr

@REM PATH
@doskey i=cd D:\i

增加到注册表 ​

window + R 输入 regedit

HKEY_LOCAL_MACHINE\Software\Microsoft\Command Processor\AutoRun
and/or
HKEY_CURRENT_USER\Software\Microsoft\Command Processor\AutoRun

找到上述目录下的文件，没有就自己创建，将脚本文件的路径改为该项的字符值即可。

windows git bash aliases ​

文件所在路径:

• D:\Git\Git\etc\bash.bashrc (在 vscode 默认终端中 alias 生效)
• D:\Git\Git\etc\profile.d\aliases.sh
• D:\Git\Git\etc\.bashrc
• D:\Git\Git\etc\.gitconfig

# My Custom aliases
alias ls='ls -F --color=auto --show-control-chars'
alias ll='ls -l'
alias i='cd D:\i'
alias ph='git push'
alias fe='git fetch'
alias pl='git pull'
alias ga='git add .'
alias gb='git branch'
alias gc='git commit -m'
alias gcf='git config --global --list'
alias cc='rimraf node_modules'
alias c='clear'

生效 git bash

source /d/git/git/etc/profile.d/aliases.sh

window git bash design ​

in path D:\Git\Git\etc\profile.d\git-prompt.sh :

PS1='\[\033]0;$TITLEPREFIX:$PWD\007\]' # set window title
# PS1="$PS1"'\n'                 # new line
# PS1="$PS1"'\[\033[32m\]'       # change to green
# PS1="$PS1"'\u@\h '             # user@host<space>
# PS1="$PS1"'\[\033[35m\]'       # change to purple
# PS1="$PS1"'$MSYSTEM '          # show MSYSTEM
PS1="$PS1"'\[\033[33m]\] '     # change to brownish yellow
PS1="$PS1"'~'                  # add custom tags
PS1="$PS1"'\[\033[33m\]'       # change to brownish yellow
PS1="$PS1"'\w'                 # current working directory

发布 npm 包 ​

• 在 npm 官网 注册账号

• 创建 npm 包 npm docs

  sh

  $ npm init

• npm package upload to github

• npm publish

  • 检查 npm 源，如果是淘宝源，则需要改回 npm 源

    sh

    # check npm registry
    $ npm config get registry
    
    # npm default registry
    $ npm config set registry https://registry.npmjs.org
    
    # taobao registry
    $ npm config set registry https://registry.npmmirror.com

  • npm login (Enter the user name, password and other information according to the terminal prompts.)

  • npm publish

• update npm package

  The console will return the next version number.

  sh

  # patch：补丁号，修复bug，小变动，如 v1.0.0 -> v1.0.1
  $ npm version patch
  
  # minor：次版本号，增加新功能，如 v1.0.0 -> v1.1.0
  $ npm version minor
  
  # major：主版本号，不兼容的修改，如 v1.0.0 -> v2.0.0
  $ npm version major

npm 版本管理规范 ​

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

版本格式：X.Y.Z[-string]

X: 主版本号； Y: 子版本号； Z: 修正版本号； string: 先行版本号及版本编译信息，如 1.0.0-x.7.z.92

1. 项目初版本时，版本号可以为 0.1.0；
2. 当项目在进行了局部修改或 bug 修正时，主版本号和子版本号都不变，修正版本号（即 z）+ 1，如升级为 0.1.x;
3. 项目正式上线的版本号应该是 1.0.0；
4. 当项目在原有的基础上增加了部分功能时，主版本号不变，子版本号（即 y）+ 1，修正版本号复位为 0，如升级为 1.x.0；
5. 当项目在进行了重大修改或局部修正累积较多，而导致项目整体发生全局变化时(或者说无法向下兼容)，主版本号(即 x) +1, 其他两位归 0， 如升级为 x.0.0;

版本范围规则 ​

1. 锁定版本号，比如 1.2.3，则每次只会安装对应的版本，一般不建议使用（如果该版本有 bug，则可能永远都修复不了）
2. x、X、\* 代替 X.Y.X 中的某一位或多位，缺省位置为任意版本号如：1.x.x 匹配主版本号 1 的所有版本，x、X、\* 三个符号等效
3. ~ 会匹配最近的小版本依赖包，比如~1.2.3 会匹配所有 1.2.x 版本，但是不包括 1.3.0
4. ^ 会匹配最新的大版本依赖包，比如^1.2.3 会匹配所有 1.x.x 的包，但是不会升级到 2.0.0
5. <、<=、>、>=、= 指定版本范围，可通过||来进行多条件组合如： 1.2.3 || >= 1.3.0 < 1.4.0

锁定版本/控制版本 ​

当首次执行 npm install 或 yarn install 之后，本地会生成 一个package-lock.json 或 yarn.lock ，其作用是：

1. 既然版本是可以动态匹配的，那么不同环境不同 npm 版本可能安装到不同的 node_modules 版本，为了确保团队成员、线上部署和持续集成能够安装完全相同的依赖包（以免酿成大祸），需要一个详细描述依赖关系树的文件
2. 是快速查看当前安装的所有 node_modules 依赖包以及各包间依赖关系的一个工具
3. 通过查看 git 的提交记录可以快速查看版本更改历史，便于定位问题
4. 通过允许 npm 跳过以前安装的包的重复元数据解析，优化安装过程。
5. npm v7 开始 package-lock.json 会包含更多的包信息，方便进行包管理与分析
6. npm 和 yarn 会有不同的包树结构，故两种安装方式建议不要混用，当心爆炸 🤭，解决方法是删掉 node_modules 再用另外一种命令进行 install

Reference ​

• npm 版本管理规范
• SemVer
• npm docs