npm install 是用于安装项目依赖的命令，必须在含 package.json 的项目根目录执行，否则报“not in a package directory”；依赖装入 node_modules，但能否使用取决于运行环境（如浏览器需 script 引入、ESM 项目可直接 import、Node.js 脚本需 require）。
VSCode 里下载 JS 库，直接用 npm install 就行，但必须确保当前终端处在项目根目录、且已运行过 npm init -y 生成 package.json——否则依赖不会被记录，下次重装就全丢了。
为什么 npm install jquery 没反应或报错 “not in a package directory”
这是最常卡住新手的第一步。VSCode 终端本身不识别“项目”，它只认当前工作路径下有没有 package.json。没有这个文件，npm install 默认拒绝写入依赖（安全机制）。
- 先确认你在正确路径：
pwd（macOS/Linux）或cd（Windows）看当前目录是否是你的项目文件夹 - 如果没
package.json，立刻执行npm init -y（加-y跳过交互，生成最小可用配置） - 别用资源管理器双击打开文件夹再启动 VSCode——可能工作区路径不对；右键文件夹 → “在 VSCode 中打开”，再从侧边栏确认当前打开的是该文件夹
- Windows 上若提示“无法加载文件 npm.ps1”，说明 PowerShell 执行策略限制，临时改用终端类型为
Command Prompt或Git Bash（右上角终端下拉菜单切换）
npm install 后包装到哪了？为什么 import $ from 'jquery' 还是报错
包默认装进 node_modules/ 子目录，但 JS 模块导入能否成功，和你用什么方式运行代码强相关——不是装上就自动可用。
- 浏览器环境直接
script标签引入：装完后去node_modules/jquery/dist/jquery.min.js找对应文件路径 - ESM（如 Vite、Webpack 项目）：装完就能
import，因为构建工具会解析node_modules - 纯 Node.js 脚本（
node index.js）：默认不支持 ESM 的import，得用require('jquery')，且需确保该包有 CommonJS 入口（jQuery 有，但很多新库没有） - VSCode 自带的 JS 文件预览（Live Server）不走 Node 模块解析，
import会 404，必须配构建工具或改用 CDN
国内装包慢、超时、证书错误？换镜像和关 SSL 校验是刚需
npm 官方源在国外，国内直连大概率失败或极慢。不换镜像，npm install 很可能卡在 “fetchMetadata” 或报 ERR_SSL_CERT_ALTNAME_INVALID。
- 换淘宝镜像（已迁至 npmmirror）：
npm config set registry https://registry.npmmirror.com - 验证是否生效：
npm config get registry，输出应为上面的地址 - 仍报 SSL 错误？临时关闭校验（仅限内网/可信环境）：
npm config set strict-ssl false - 慎用
cnpm：它只是 npm 的封装，命令行为略有差异（比如cnpm install默认加--save），长期混用易导致package-lock.json冲突
装完包，node_modules 太大，能删吗？怎么备份项目？
能删，而且应该删——它不该进 Git，也不该随项目打包传输。
-
node_modules是纯生成物，由package.json和package-lock.json精确描述，删掉后只要运行npm install就能 100% 复原 - 团队协作或部署时，只提交
package.json和package-lock.json，其他人git clone后执行一次npm install即可 - 不要手动修改
node_modules里的文件来“调试”，改了也白改——下次install或update就覆盖掉 - 想临时改某包源码？用
npm link或file:协议本地引用，而不是硬编辑node_modules
真正容易被忽略的点是：VSCode 终端的“当前路径”和“VSCode 工作区”未必一致，而 npm 只认路径，不认窗口标题。多开几个终端、切错目录、或者用 VSCode 的“远程 SSH”连接时没激活正确工作区，都会让 npm install 看似执行成功，实则装到了别的地方。
