{
  "name": "package-demo",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

字符串與 "^(?:(?:@(?:[a-z0-9-*~][a-z0-9-*._~]*)?/[a-z0-9-._~])|[a-z0-9-~])[a-z0-9-._~]*$" 的模式不匹配。

PS D:\lucky-file\package-demo> npm search 'react runtime clsx'        
NAME                      | DESCRIPTION          | AUTHOR          | DATE       | VERSION  | KEYWORDS
react-auto-clsx           |                      | =crazy-code     | 2023-10-10 | 1.1.0    | react vite webpack className clsx runtime
react-runtime-clsx        |                      | =zsh-yzy        | 2023-11-30 | 0.0.1    | react vite webpack className clsx runtime
react-auto-classnames     | JSX runtime for…     | =meowtec        | 2022-09-30 | 1.0.2    | react classnames clsx jsx-runtime
PS D:\lucky-file\package-demo> 

license

指定一個(gè)許可證，以便人們知道他們?nèi)绾伪辉试S使用它，以及你對(duì)其施加的任何限制,常見的開源協(xié)議是 MIT 和 BSD,如果我們不確定我們應(yīng)該如何寫，可以看一下網(wǎng)上這個(gè)圖說的比較清晰借用一下：

author

它表示項(xiàng)目的作者信息，它既可以是一個(gè)字符串，又可以是一個(gè)對(duì)象

"author":{
  "name": "lvz",
  "email": "xxxx@xx.com",
  "url": "https://xxxxx"
}

"funding": [
    {
      "type": "patreon",
      "url": "http://XXXXXX"
    },
    "http://XXXXX",
    {
          "type": "open",
      "url": "https://XXXXXX"
    }
  ]

files

項(xiàng)目在進(jìn)行 npm 發(fā)布時(shí)，可以通過 files 指定需要跟隨一起發(fā)布的內(nèi)容來控制 npm 包的大小，避免安裝時(shí)間太長(zhǎng)，比如我們包體有很多文件，但我們只想把dist放進(jìn)去，其他src,test文件并不想放在包體中，可以使用這個(gè)字段

但無論設(shè)置如何，總是會(huì)包含某些文件：

• package.json
• README
• CHANGES?/?CHANGELOG?/?HISTORY
• LICENSE?/?LICENCE
• NOTICE
• “main”字段中的文件 相反，某些文件總是被忽略：
• .git
• CVS
• .svn
• .hg
• .lock-wscript
• .wafpickle-N
• .*.swp
• .DS_Store
• ._*
• npm-debug.log
• .npmrc
• node_modules
• config.gypi
• *.orig
• package-lock.json

當(dāng)然除了files 也有其它方式可以來忽略文件進(jìn)入包體，我們先看一下我們什么也不處理的文件格式

1. 添加.gitignore文件

src/*
example/*

src/*
example

 "repository": {
    "type": "git",
    "url": "https://github.com/xxxxx",
    "directory": "xxxx/xxx"
  }

"repository":"https://github.com/xxxxx/xxxx"

  "config": {
    "type": "chrome"
  },

console.log(process.env.npm_package_config_type)

 "scripts": {
    "start": "node index.js"
  },

"dependencies": {
    "lucky-package-demo": "*"
}

devDependencies

簡(jiǎn)單理解就是這個(gè)包是開發(fā)環(huán)境用到了，生產(chǎn)環(huán)境并不需要它，比如我們的webpack，vite，或是eslint等

我們?cè)趐ackage-demo 中安裝?vite

"devDependencies": {
    "vite": "4.3.0"
}

"devDependencies": {
    "react": "17.0.2",
    "vite": "4.3.0"
},
"peerDependencies": {
    "react":">16.8.0 <18.0.0"
}

dependencies:
- lucky-package-demo
+ lucky-package-demo 0.0.10
- react
+ react 16.8.0 (18.2.0 is available)

?WARN? Issues with peer dependencies found
.
└─┬ lucky-package-demo 0.0.10
  └── ? unmet peer react@">16.8.0 <18.0.0": found 16.8.0

peerDependenciesMeta

如果?peerDependencies?中指定的包尚未安裝，npm 將發(fā)出警告，如下配置將對(duì)等依賴標(biāo)記為可選，如果用戶沒有安裝對(duì)等依賴，npm不會(huì)發(fā)出警告

 "peerDependenciesMeta":{
    "react":{
      "optional":true
    }
  }

optionalDependencies

通過npm 命令 -O, --save-optional

npm i -O [package-name]

optionalDependencies 用于定義可選依賴項(xiàng)，和 dependencies 非常類似，主要的差別在于：在 optionalDependencies 中的依賴包安裝報(bào)錯(cuò)甚至找不到時(shí)不會(huì)影響到包管理器的安裝行為

npm i -O react-runtime-clsx
// package-demo package.json 如下：
"optionalDependencies": {
    "react-runtime-clsx": "0.0.1"
}

optionalDependencies?中的條目將覆蓋?dependencies?中的同名條目，因此通常最好只放在一個(gè)位置

overrides

如果需要對(duì)依賴項(xiàng)的依賴項(xiàng)進(jìn)行特定更改，例如將依賴項(xiàng)的版本替換為已知的安全問題，將現(xiàn)有依賴項(xiàng)替換為分支，或者確保在任何地方都使用相同版本的包，則可以添加覆蓋。

package-demo中package.json 配置

"optionalDependencies": {
    "react-runtime-clsx": "0.0.1"
  }

具體的大家可以看一下文檔overrides文檔 )

項(xiàng)目中的依賴

項(xiàng)目中我們也會(huì)有依賴，有些是輔助開發(fā)的工具，有些是項(xiàng)目引用的代碼包，因?yàn)轫?xiàng)目我們是不會(huì)發(fā)布它作為npm包來使用的，它作為的是一個(gè)工程，所以在依賴上是有區(qū)分的，你是不是也有下面的困惑呢？

我隨便裝的并不影響到開發(fā)和構(gòu)建，似乎這兩者沒有區(qū)別，安裝哪里都一樣呢？

感覺是對(duì)的，其實(shí)項(xiàng)目中這兩者并沒有明顯的劃分，只是我們通常是將開發(fā)中使用的安裝到devDependencies,運(yùn)行使用的放在dependencies,其實(shí)這兩個(gè)都是安裝了的，無論你放哪都可以使用，所以也有部分剛接觸時(shí)很困惑，因?yàn)檫@個(gè)針對(duì)的是npm發(fā)布包有用的，在項(xiàng)目中還是按規(guī)范了養(yǎng)成習(xí)慣，清楚每個(gè)的含義，對(duì)我們做npm包的發(fā)布是有用的哈