Sublime Text安装并配置Django框架开发环境

阿芳酱_6804

阿芳酱_6804

2026-08-06

294人浏览

原创

Sublime Text本身不运行Django,仅作为编辑器依赖本地Python环境;需先验证django-admin可用性,再手动配置构建系统指定虚拟环境解释器路径和项目工作目录,并为模板文件手动切换Django语法高亮。

sublime text安装并配置django框架开发环境

Sublime Text 本身不运行 Django,它只是编辑器;真正起作用的是你本地 Python 环境里装的 django 和 django-admin。只要终端能跑 django-admin startproject,Sublime 就能配合开发——关键在环境对齐,不在编辑器功能多强。

确认 django-admin 是否可用,别跳过这步

很多人卡在这一步却以为是 Sublime 配置错了。打开终端,执行:

django-admin --version

如果有输出(比如 4.2.7),说明 Django 已安装且在 PATH 中;如果报 command not found 或 'django-admin' is not recognized,那就不是 Sublime 的问题,而是:

  • 没装 Django:pip install django
  • 装了但没进 PATH:检查是否用了虚拟环境,且没激活(source venv/bin/activate 或 venv\Scripts\activate.bat)
  • PATH 没刷新:Windows 用户重启命令行,macOS/Linux 用户检查 .zshrc 或 .bash_profile 是否导出正确路径

Sublime 的构建系统默认调用系统级 python 和 django-admin,不会自动读取你当前 shell 激活的虚拟环境。

配置 Build System 运行 manage.py,路径必须写死

Sublime 默认没有 Django 构建能力,得手动加一个 .sublime-build 文件。重点不是“怎么写”,而是“路径不能错”:

  • 新建构建系统:Tools → Build System → New Build System
  • 填入以下内容(注意替换 /path/to/your/project 和解释器路径):
{
  "cmd": ["/path/to/your/venv/bin/python", "-u", "/path/to/your/project/manage.py", "runserver"],
  "working_dir": "/path/to/your/project",
  "file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)",
  "selector": "source.python"
}

常见坑:

Django Wrap
Django Wrap

强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能,主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该

下载
  • cmd 里写的 Python 路径必须是你项目实际用的解释器,比如虚拟环境里的 venv/bin/python,不是系统 /usr/bin/python3
  • working_dir 必须设为项目根目录(含 manage.py 的那层),否则 runserver 找不到 settings.py
  • 别指望 Sublime 自动识别 venv 目录——它不读 pyproject.toml 或 requirements.txt

Django 模板高亮要手动切换语法,不能靠文件后缀猜

装完 Djaneiro 或 HTML (Django Templates) 插件后,.html 文件依然灰成一片,是因为 Sublime 默认按原生 HTML 解析。必须显式指定语法:

  • 打开一个模板文件(如 templates/base.html)
  • 点击窗口右下角当前语法名(通常是 HTML)
  • 从菜单中选 Django > HTML (Django)(Djaneiro)或 HTML (Django Templates)

如果你硬要全局绑定所有 .html 文件:

{"extensions": ["html"], "syntax": "Packages/HTML/HTML (Django Templates).sublime-syntax"}

但代价是:前端组件、静态页、Markdown 导出的 HTML 全部失去 Emmet 补全和原生 HTML 标签提示。更稳妥的做法是只对 templates/ 下的文件生效——这需要 ApplySyntax 插件,但维护成本高,多数人用不到。

{% static %} 和 {% url %} 永远灰色,这不是 bug 是机制限制

即使语法插件装了、路径设对了、语法也手动切换了,{% static %}、{% url %}、{% load i18n %} 这些标签还是和 {% if %} 一样颜色。原因很实在:

  • Sublime 的 .sublime-syntax 基于静态正则匹配,无法解析 {% load static %} 动态引入的标签库
  • 所有自定义模板标签都被当作普通 block 处理,作用域(scope)没区分
  • 改语法文件硬加规则?升级插件时会被覆盖,还容易破坏括号匹配逻辑

接受这个事实比折腾高亮更省时间。真要验证这些标签是否写对,靠 python manage.py runserver 启起来看页面报错,或者用 SublimeLinter + django-html-linter 做静态检查,比颜色靠谱得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

2026.02.04

613

30

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

2026.06.29

280

15

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

20

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程