SuperAPI AI 工具集

env-debug

部署与运维

查看项目

更新于 10-15 07:47

技能介绍

用途

env-debug 是一个面向命令行环境问题的排查与修复技能,属于 1mangesh1/dev-skills-collection 集合。当用户遇到诸如“fix PATH”“command not found”这类环境故障时,该技能提供系统化的诊断思路与可直接执行的命令,帮助定位并修复 PATH、权限、环境变量和配置问题。

主要能力

该技能覆盖多个常见故障领域。

命令找不到与 PATH 排查:通过 which、command -v、type、whereis 等命令检查命令是否存在及其位置,查看 PATH 内容,并提供将 /usr/local/bin、$HOME/.local/bin、$HOME/.cargo/bin、$HOME/go/bin、nvm 的 Node 版本目录等加入 PATH 的写法,以及写入 ~/.bashrc、~/.zshrc、~/.profile 使其永久生效的方法。

Shell 配置:检查当前使用的 Shell 与加载模式,说明 bash 与 zsh 登录/非登录时的配置文件加载顺序,提供 source 重新加载配置的方式,以及判断当前 Shell 是否交互式或登录式的方法。

环境变量管理:使用 env、printenv、echo 查看变量;使用 export 为当前会话或单条命令设置变量、unset 取消变量;判断变量是否已设置;并给出 .env 文件在 Node.js(dotenv 或 node --env-file=.env app.js,Node 20.6+)、Python(python-dotenv)以及 Shell(source .env 等)中的加载方式。

权限问题:解释权限字符串含义,提供 chmod +x、chmod 755 等赋权方式,修复 npm 全局权限、SSH 密钥权限(700、600、644),查看文件归属并用 chown 修复所有权。

端口占用:使用 lsof、ss、netstat 查找占用端口的进程,用 lsof 或 fuser 结束进程,并用 nc 检查端口是否可用。

Node.js 问题:排查多版本、nvm 命令,清理 npm 缓存,重装 node_modules,查看全局包位置,处理 npx 找不到包的情况。

Python 问题:排查多版本 Python、虚拟环境是否激活、pip 与 Python 的对应关系,定位模块导入路径,处理 pyenv 相关命令。

DNS 与网络:提供 nslookup、dig、host、ping、curl、nc、openssl 等连通性与证书检查命令,并查看代理环境变量。

Docker 问题:检查守护进程、修复权限组、处理容器内 DNS 与容器连接问题。

磁盘空间:使用 df、du 查看占用,定位大文件,并提供针对 node_modules 与 Docker 的清理方式。

使用方式

该技能以命令参考和示例为主。用户可按问题类型直接查阅对应命令并在终端执行。此外还提供一个诊断脚本,依次打印系统信息、Shell、PATH 每行内容、node/npm/python/python3/pip/git/docker 是否存在及版本,以及 NODE_ENV、VIRTUAL_ENV 等关键变量。

适用场景

适用于本地或服务器开发环境中遇到命令找不到、PATH 配置错误、环境变量未生效、文件权限不足、端口冲突、Node.js 或 Python 工具链混乱、网络与 DNS 异常、Docker 权限与连通性故障、磁盘空间告警等典型问题时的快速排查与修复。

限制

本技能以命令行诊断与修复为核心。资料中未提供图形界面功能、收费信息、支持平台列表或自动化修复能力,相关具体限制暂未提供。