排障与清理

找不到 myenv 命令

安装后退出整个终端应用并重开。Windows 运行 Get-Command myenv -All，检查同名函数/别名和 PATH；也可直接用安装目录下的 exe。

声明与环境不一致

myenv status
myenv sync
myenv doctor

如需暂时使用旧活动环境，显式选择 run --current。run 不会隐式帮你下载缺少的工具。

检查文件内容

myenv doctor --deep

深度检查比较环境代内容基线，可能较慢。它不检查外部共享运行时内容、Python 字节码缓存或 ACL，也不自动修复。

安全清理

myenv clean --dry-run
myenv clean

保留当前、上一代和仍受运行/准备保护的环境。无法确认后代进程退出时继续保留保护；不要手动删除租约绕过检查。用户默认环境用 myenv system clean --dry-run 预览，clean 不接受 --global。

myenv clean --cache node --dry-run
myenv clean --cache uv --dry-run

缓存清理不卸载共享 Python 解释器。项目 venv 可能引用共享解释器，不要随意手动删除。

GUI 检查不到终端中的 Node / Python

先在终端核对命令的完整路径，再退出 GUI 重开并刷新检查。GUI 使用启动时继承的 PATH，不会自动执行 PowerShell 别名或 Shell 启动脚本。myEnv 工具链未配置某个语言，也不代表本机没有安装，详见本机与默认工具。

官方查询失败或没有结果

“官方未找到”与网络错误是不同结果。npm 可以搜索关键词，PyPI 需要完整包名；先检查拼写，再重试。网络失败时检查代理、证书和网络连接，不要把失败结果当成安装包已消失。版本查询较慢时看底部活动状态；需要时取消并等待收尾。

包操作部分失败或已取消

展开执行结果，区分已完成、失败、取消和未执行的条目，然后刷新原列表。已完成的外部包变更不会自动撤销；只对仍需处理的条目重新生成计划。遇到权限、安装脚本或不支持的工作区说明时，按提示使用原管理器。

颜色与进度

交互终端自动显示颜色与单行阶段动画，重定向保留普通文本。NO_COLOR=1 关闭装饰；--no-input、--verbose 或 --json 关闭动画。命中已有环境时可能没有准备阶段。用户程序输出保持原样。

反馈问题

保留 myenv --version、失败命令、完整输出及紧接着读取的 $LASTEXITCODE。可以附原始截图；公开分享前检查是否包含凭据或不希望公开的信息。