从痛点一来看，面对 npm 警告不知所措

在 Windows 环境下执行全局安装 @wechat-miniprogram/miniprogram-cli 时常会看到很多 deprecated 与安全警告，例如：

F:\business-system\weixin-app-order>npm install -g @wechat-miniprogram/miniprogram-cli
npm WARN deprecated inflight@.: This module is not supported。and leaks memory...
npm WARN deprecated rimraf@.: Rimraf versions prior to v4 are no longer supported
npm WARN deprecated glob@.: Old versions of glob are not supported,and contain widely publicized security vulnerabilities...
added packages in 38s
packages are looking for funding
run `npm fund` for details

这些信息往往让新手误以为安装失败。只要 npm 没有报错，就表示 CLI 已经成功写入。

至于步骤一，正确安装 miniprogram-cli

打开命令行。执行下面的命令：

npm install -g @wechat-miniprogram/miniprogram-cli

关键点：

• 确保网络通畅，若出现下载超时可添加国内镜像。
• 全局安装后miniprogram 可在任意目录直接调用。
• 即使出现上文的 deprecated 警告。也不影响后续使用，只要没有 Error: 即可。

再看痛点二，不知道是否安装成功，找不到帮助文档

很多开发者在完成全局安装后直接尝试运行项目。却提示 “'miniprogram' 不是内部或外部命令，也不是可运行的程序或批处理文件。`”，从这通常是因为来看，

• PATH 环境变量未刷新：重新打开一个新的终端窗口。
• 权限不足：以管理员身份运行终端或使用 sudo。

验证安装是否成功

miniprogram --help
# 或者查看版本号
miniprogram -V

如果返回类似下面内容，则说明 CLI 已经可用：

Usage: cli
Options:
-V,--version output version number
-h。--help output usage information
Commands:
init create a project with template project
upgrade upgrade miniprogram custom component framework
cache show path of template projects cache

从痛点三来看，不清楚如何快速创建一个标准的小程序项目模板

很多新人在阅读官方文档时会被繁琐的参数列表搞糊涂。其实只需要指定模板类型并加上 --newest 参数，即可获得最新的官方脚手架。

初始化微信小程序项目

miniprogram init --type miniprogram . --newest

解释每个参数的意义：

• init: 调用初始化命令。
• --type miniprogram: 指定项目类型为普通小程序（还有 "custom-component"。"plugin","game")。
• .: 将项目生成在当前目录。老实说，如果想放到其他文件夹，可替换为目标方法。 例如 /my-wxapp.
• --newest: 使用官方最新模板，避免因旧模板导致的兼容性问题。其实，
• -f / --force: 如需覆盖已有文件。可额外加上此选项，

常见错误及对应方法

npm i -g npm-check-updates && ncu -u && npm install -g @wechat-miniprogram/miniprogram-cli@latest 

npm install && npm run dev 

npm i -g @wechat-miniprogram/miniprogram-cli@latest 

miniprogram init --type miniprogram . --proxy http://127.0.0.1:1080 

从结束语来看。从“怕报错”到“一键搞定”

只要按顺序完成「全局安装 → 验证 → 初始化」三步，即可摆脱「找不到命令」和「模板老旧」的困扰。后续可以直接在 VS Code 中打开生成好的目录，使用官方提供的 DevTools 预览、调试与上传。祝你玩得开心 🚀，