# Django 5.2.8 documentation

# 错误调试

本页包含了开发Django应用过程中一些常见错误和问题的处理建议。

## 运行 `django-admin` 时遇到的问题

### `command not found: django-admin`

如果你是通过 `pip` 安装 Django 的，django-admin 应该在你的系统路径中。如果它不在你的路径中，请确保你已经激活了你的虚拟环境，你可以尝试运行等效的命令 `python -m django`。

### macOS 的权限问题

如果你正在使用 macOS，你可能看到“permission denied”提示，当你尝试运行``django-admin``的时候。这是因为在像 macOS 这种类Unix系统中，一个文件在它被当作程序执行之前必须被标记为“可执行”。为了解决这个问题，打开终端并且进入 django-admin `的安装目录（使用``cd``命令），然后执行命令``sudo chmod +x django-admin`.

## 杂项

### 我遇到了错误信息 `UnicodeDecodeError`。 我哪里做错了？

当包含非 ASCII 序列的字节字符串转换为 Unicode 字符串并且指定的编码不正确时，会发生此类错误。输出通常如下所示：

    UnicodeDecodeError: 'ascii' codec can't decode byte 0x?? in position ?:
    ordinal not in range(128)

解决方案主要取决于上下文，但是这里有两个常见的陷阱产生这个错误：

- 您的系统语言环境可能是默认的ASCII，比如类UNIX系统上的 “C” （可通过命令 `locale` 进行检查）。如果是这种情况，请参考您的系统文档以了解如何将其更改为UTF-8语言环境。

关联资源：

- Django 中的 Unicode

- https://wiki.python.org/moin/UnicodeDecodeError