django-admin 找不到命令是因为其脚本未加入 $PATH，需通过 pip show django 查位置并添加对应 bin 目录到 PATH，或临时用 python -m django.core.management 代替。
pip install django 之后为什么 django-admin 找不到命令
常见现象是终端报错 command not found: django-admin，尤其在 macOS 或 Linux 上用非系统 Python（比如 pyenv、conda）时。根本原因不是安装失败，而是 django-admin 脚本没进 $PATH。
实操建议：
- 先确认安装成功：
pip show django看输出里有没有Location:和Version: - 查
django-admin实际位置：python -m django --version能返回版本就说明 Django 可用；再运行python -m pip show django | grep Location，然后去那个目录下的bin/（Linux/macOS）或Scripts/（Windows）里找django-admin - 临时解决：直接用
python -m django.core.management代替django-admin，比如创建项目写成python -m django.core.management startproject mysite - 长期解决：把对应
bin目录加进$PATH，例如export PATH="/Users/xxx/.pyenv/versions/3.11.5/bin:$PATH"（路径按pip show django的Location推导）
Django 4.x/5.x 创建 project 时必须指定 Python 版本吗
不必须，但强烈建议明确指定解释器路径，尤其当你机器上有多个 Python 版本时。Django 本身不校验 Python 版本兼容性，但 startproject 生成的 manage.py 会硬编码 shebang 行，比如 #!/usr/bin/env python3 —— 这行如果指向旧版 Python，后续 runserver 可能出语法错误（如 3.8 以下不支持 := 海象运算符）。
实操建议：
- 用
python3.11 -m django startproject mysite显式指定解释器，比单纯django-admin startproject mysite更可控 - 检查生成的
manage.py第一行是否匹配你预期的 Python 版本，不对就手动改（如改成#!/usr/bin/env python3.11） - 如果用 virtualenv，确保激活后执行
python -m django startproject，这样 shebang 会自动指向虚拟环境里的 Python
startproject 生成的目录结构里，mysite/mysite/ 是多余的吗
不是多余，这是 Django 的标准分层设计：mysite/（外层）是项目根目录，放 manage.py 和部署相关文件；mysite/mysite/（内层）是实际的 Python 包，含 settings.py、urls.py 等核心配置。拆开是为了避免把项目配置和应用代码混在同一级。
常见错误现象：有人删掉内层 mysite，把 settings.py 拖到外层，结果 python manage.py runserver 报 ModuleNotFoundError: No module named 'mysite.settings'。
实操建议：
- 别重命名或移动内层包名，否则要同步改
manage.py里的os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings') - 如果想自定义内层包名，用
django-admin startproject mysite --name=myapp不生效；正确做法是先生成再重命名目录 + 改环境变量值 - 部署时，
sys.path需包含外层mysite/目录，不是内层
Windows 下 manage.py runserver 启动失败，提示 UnicodeDecodeError
典型错误信息是 UnicodeDecodeError: 'gbk' codec can't decode byte 0xa6 in position ...，本质是 Windows 默认控制台编码为 GBK，而 Django 读取 settings.py 或模板文件时按 UTF-8 解码失败。
实操建议：
- 最简单：在项目根目录下新建
.env文件，写入PYTHONIOENCODING=utf-8，然后用pip install python-dotenv并在manage.py开头加import os; from dotenv import load_dotenv; load_dotenv() - 快速绕过：启动前在 CMD 中执行
chcp 65001（切换为 UTF-8 模式），再运行python manage.py runserver - 一劳永逸：用 VS Code 或 PyCharm 启动，它们默认用 UTF-8 读取文件，且终端编码可控
复杂点在于，这个错误可能不只出现在 runserver，还可能卡在 migrate 或加载静态文件时——只要涉及文件 I/O 且内容含中文或特殊符号，就得统一编码上下文。
