---
title: "错误调试"
version: 5.1
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/5.1/faq/troubleshooting/
canonical: https://djangodocs.dev/zh-hans/5.1/faq/troubleshooting/
---
# 错误调试

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

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

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

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

### macOS 的权限问题

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

## 杂项

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

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

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

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

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

关联资源：

- [Django 中的 Unicode](/zh-hans/5.1/ref/unicode/)
- <https://wiki.python.org/moin/UnicodeDecodeError>