ni项目卸载指南：如何完全卸载ni及其相关文件

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目录生成多个可执行文件，包括：

• ni
• nci
• nr
• nup
• nd
• nlx
• na
• nun

这些文件路径通常为：

• 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]：

1. 环境变量NI_CONFIG_FILE指定的路径
2. 默认路径~/.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