ni项目卸载指南：如何完全卸载ni及其相关文件
【免费下载链接】ni 💡 Use the right package manager 项目地址: https://gitcode.com/gh_mirrors/ni/ni
你是否在使用ni（Use the right package manager）后，因需求变化需要彻底卸载它？本文将带你完成从基础卸载到深度清理的全过程，确保系统中不留任何残留文件。读完本文，你将掌握不同包管理器下的卸载方法、配置文件清理技巧以及手动检查残留的实用步骤。
1. 基础卸载：使用对应包管理器移除ni
ni作为npm包发布，包名为@antfu/nipackage.json。根据你安装ni时使用的包管理器，执行以下命令进行基础卸载：
npm卸载
npm uninstall -g @antfu/ni
yarn卸载
yarn global remove @antfu/ni
pnpm卸载
pnpm remove -g @antfu/ni
bun卸载
bun remove -g @antfu/ni
注意：全局安装的ni需要使用-g或global参数。若你曾在项目本地安装ni，请进入对应项目目录，不带全局参数执行上述命令。
2. 配置文件清理：删除.nirc与环境变量
ni的核心配置存储在~/.nirc文件中[src/config.ts#L14]。该文件包含默认包管理器、全局代理等关键设置。使用以下命令彻底删除：
# Linux/macOS
rm -f ~/.nirc
# Windows (PowerShell)
Remove-Item -Path $env:USERPROFILE\.nirc -Force
此外，ni还会读取以下环境变量，建议检查并清除：
NI_CONFIG_FILE：自定义配置文件路径NI_DEFAULT_AGENT：默认包管理器设置NI_GLOBAL_AGENT：全局代理配置
3. 残留文件检查：手动清理系统路径
即使完成上述步骤，系统中可能仍存在以下残留文件：
二进制可执行文件
ni会在全局bin目录生成多个可执行文件，包括：
nincinrnupndnlxnanun
这些文件路径通常为：
npm：/usr/local/bin/ 或 ~/.npm-global/bin/yarn：~/.yarn/bin/pnpm：~/.pnpm-global/5/node_modules/.bin/
缓存目录
检查并删除ni相关缓存：
# npm缓存
npm cache clean --force
# yarn缓存
yarn cache clean
# pnpm缓存
pnpm store prune
4. 验证卸载：确认ni已完全移除
执行以下命令验证卸载结果：
# 检查命令是否存在
which ni || where ni
# 尝试运行ni命令
ni --version
若输出"command not found"或类似提示，说明ni已成功卸载。你还可以检查包管理器的全局安装列表：
# npm
npm list -g | grep @antfu/ni
# yarn
yarn global list | grep @antfu/ni
# pnpm
pnpm list -g | grep @antfu/ni
5. 常见问题解决
卸载后命令仍可执行？
这可能是因为shell缓存了命令路径。执行以下命令刷新：
# bash/zsh
hash -r
# fish
rehash
权限错误？
使用sudo重试卸载命令（Linux/macOS）：
sudo npm uninstall -g @antfu/ni
找不到.nirc文件？
ni配置文件路径优先级为[src/config.ts#L8-L16]：
环境变量NI_CONFIG_FILE指定的路径默认路径~/.nirc
可通过以下命令定位：
# Linux/macOS
find ~ -name ".nirc" 2>/dev/null
# Windows (PowerShell)
Get-ChildItem -Path $env:USERPROFILE -Filter ".nirc" -Recurse -ErrorAction SilentlyContinue
总结
完全卸载ni需完成三个关键步骤：基础卸载（移除包文件）、配置清理（删除.nirc与环境变量）、残留检查（清理可执行文件与缓存）。遵循本文方法，可确保系统中不遗留任何ni相关文件，为重新安装或切换其他工具做好准备。
若你在卸载过程中遇到其他问题，可查阅官方文档或提交issue获取帮助。
【免费下载链接】ni 💡 Use the right package manager 项目地址: https://gitcode.com/gh_mirrors/ni/ni