> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 环境问题
> 解决系统环境和配置问题
解决与系统环境、Shell 和依赖项相关的常见问题。
## PowerShell 未识别
**问题：** 错误信息 "PowerShell is not recognized as an internal or external command"。
**解决方案：**
* **Windows 用户：**
* 将 PowerShell 添加到系统 PATH
* 打开设置 → 系统 → 关于 → 高级系统设置 → 环境变量
* 添加 PowerShell 路径：`C:\Windows\System32\WindowsPowerShell\v1.0\`
* 更改 PATH 后重启 SoloEnt
* **替代方案：**
* 改用命令提示符（cmd）
* 在设置中更改默认终端
* 如缺失则重新安装 PowerShell
## 命令未找到
**问题：** 终端显示 "command not found" 或类似错误。
**解决方案：**
* 验证命令/工具已安装在你的系统上
* 检查命令是否在系统 PATH 中
* 安装新工具后重启终端
* 如需要，使用可执行文件的完整路径
* 安装缺失的依赖项
## Python/Node 未找到
**问题：** Python 或 Node.js 命令无法工作。
**解决方案：**
* 从 python.org 安装 Python 或从 nodejs.org 安装 Node.js
* 验证安装：`python --version` 或 `node --version`
* 如已安装但未识别，添加到 PATH
* 安装后重启 SoloEnt
* 检查版本冲突（多个 Python/Node 版本）
## 权限被拒绝错误
**问题：** "Permission denied" 或 "Access denied" 错误。
**解决方案：**
* **macOS/Linux：**
* 如适当，使用 `sudo`
* 使用 `ls -la` 检查文件权限
* 在系统设置中授予完全磁盘访问权限
* **Windows：**
* 如需要，以管理员身份运行 SoloEnt
* 检查文件夹安全设置
* 暂时禁用用户账户控制
## 路径中有空格导致错误
**问题：** 文件路径包含空格时命令失败。
**解决方案：**
* 用引号包裹路径：`"C:\My Documents\project"`
* 在终端中使用转义字符
* 避免在项目文件夹名称中使用空格
* 改用连字符或下划线：`my-project` 而非 `my project`
## Git 不可用
**问题：** Git 命令无法工作或找不到 Git。
**解决方案：**
* 从 git-scm.com 安装 Git
* 验证安装：`git --version`
* 将 Git 添加到系统 PATH
* 安装后重启终端/SoloEnt
* 使用 GitHub Desktop 作为替代方案
## 环境变量未设置
**问题：** 应用程序找不到所需的环境变量。
**解决方案：**
* 在系统设置中设置变量（不仅仅是终端会话）
* **Windows：** 系统属性 → 环境变量
* **macOS/Linux：** 添加到 `~/.zshrc` 或 `~/.bashrc`
* 设置变量后重启 SoloEnt
* 使用 `echo $VARIABLE_NAME`（Unix）或 `echo %VARIABLE_NAME%`（Windows）验证
## Shell 兼容性问题
**问题：** 命令在一个 Shell 中工作但在另一个中不工作。
**解决方案：**
* 检查你正在使用的 Shell：`echo $SHELL`
* 切换到兼容的 Shell（bash、zsh、PowerShell）
* 在 SoloEnt 设置中配置默认 Shell
* 尽可能使用跨平台命令
## 系统架构不匹配
**问题：** 工具或二进制文件与你的系统不兼容。
**解决方案：**
* 检查系统架构：`uname -m`（Unix）或 `systeminfo`（Windows）
* 下载正确的版本（x64、ARM64 等）
* 使用兼容的替代方案
* 如需要，在 Apple Silicon Mac 上启用 Rosetta 2
## 杀毒软件阻止操作
**问题：** 杀毒软件干扰 SoloEnt 操作。
**解决方案：**
* 将 SoloEnt 添加到杀毒软件白名单/例外
* 暂时禁用杀毒软件进行测试
* 检查杀毒软件日志了解被阻止的操作
* 联系杀毒软件支持了解正确配置
## 磁盘空间问题
**问题：** 由于磁盘空间不足，操作失败。
**解决方案：**
* 检查可用磁盘空间
* 清理临时文件和缓存
* 将项目移动到空间更大的驱动器
* 删除不必要的文件
## 网络/防火墙问题
**问题：** 无法连接到 API 服务或下载更新。
**解决方案：**
* 检查防火墙设置
* 允许 SoloEnt 通过防火墙
* 如在企业防火墙后，配置代理设置
* 使用不同网络测试连接
* 对于企业环境，联系 IT 部门
许多环境问题可以通过在进行系统更改（如 PATH 更新或安装新工具）后重启 SoloEnt 来解决。
## 仍有问题？
联系我们的支持团队并提供环境详情
从社区获取帮助
返回故障排除索引
返回设置指南
## 报告环境问题
报告环境问题时，请包含：
* **操作系统**：Windows 10/11、macOS 版本、Linux 发行版
* **系统架构**：x64、ARM64、Apple Silicon
* **Shell 类型**：PowerShell、CMD、bash、zsh
* **错误消息**：任何错误的完整文本
* **已采取的步骤**：报告前你尝试了什么
这些信息有助于我们更快地诊断和解决问题。