# Django 5.0.9.dev20240806133106 ドキュメント

# トラブルシューティング

このページでは、Django アプリの開発でよく起こるエラーや問題に関するアドバイスを説明してます。

## `django-admin` 実行時の問題

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

Djangoを `pip` 経由でインストールした場合、 django-admin はシステムパス上に設定されているはずです。もしシステムパスにない場合、仮装環境が有効になっていることを確認した上で、同等のコマンドである `python -m django` を実行してみてください。

### macOS のパーミッション

macOSを使用している場合、 `django-admin` を実行しようとすると "permission denied" というメッセージが表示されることがあります。これは、macOS のような UNIX ベースのシステムでは、ファイルをプログラムとして実行する前に、ファイルを "実行可能" とマークする必要があるからです。これを行うには、Terminal.app を開き、 `cd` コマンドを使って django-admin がインストールされているディレクトリに移動し、 `sudo chmod +x django-admin` コマンドを実行します。

## その他

### `UnicodeDecodeError` が発生しました。何を間違えてしまったのでしょうか？

この種のエラーは、非 ASCII シーケンスを含むバイト文字列がUnicode文字列に変換され、指定されたエンコーディングが正しくない場合に発生します。 出力は一般的に次のようになります:

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

解決策は主にコンテキストに依存しますが、このエラーを引き起こす2つの一般的な落とし穴には以下のようなものがあります:

- あなたのシステムロケールは、UNIX ライクなシステム上の "C" ロケールのような、デフォルトの ASCII ロケールであるかもしれません（ `locale` コマンドで確認できます）。 その場合は、システムのマニュアルを参照して、これを UTF-8 ロケールに変更する方法を確認してください。

関連資料:

- Django における Unicode
- https://wiki.python.org/moin/UnicodeDecodeError