Sublime Text 可通过 EnvFile 插件实现项目级 dotenv 环境变量管理,自动加载 .env、.env.development 等文件,并配合自定义 Build System 注入环境变量,无需修改源码或依赖外部脚本。

Sublime Text 本身不原生支持 dotenv 文件或自动加载环境变量,但可以通过插件和简单配置实现项目级环境变量管理,配合 .env 文件隔离开发与生产配置。
安装 Sublime 插件支持 dotenv
推荐使用 EnvFile 插件(兼容 Sublime Text 3/4),它能识别项目根目录下的 .env、.env.development、.env.production 等文件,并在运行命令(如 Build System)时自动注入环境变量。
- 通过 Package Control 安装:按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Install Package,搜索并安装EnvFile - 安装后无需额外启用,插件会自动检测当前项目根目录下的
.env*文件 - 支持多环境文件优先级:例如当前设置为
development时,会优先加载.env.development,再 fallback 到.env
配置项目专属 Build System(含环境变量)
Sublime 的 Build System 可以绑定特定环境变量,配合 EnvFile 插件即可实现“一键运行带配置的脚本”。
- 菜单栏选择
Tools → Build System → New Build System… - 写入类似以下内容(以 Python 为例):
{
"cmd": ["python", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"env": {
"ENVIRONMENT": "development"
}
}
保存为 Python with Env.sublime-build,之后该构建系统会将 ENVIRONMENT=development 注入进程,并触发 EnvFile 自动加载对应 .env.development 中的变量。
项目级 .env 文件组织建议
不依赖全局环境,把配置收敛到项目内,便于协作与部署一致性。
.env:通用变量(如PROJECT_NAME=myapp),所有环境共享,不提交到 Git.env.development:本地调试用(如API_URL=http://localhost:3000,DEBUG=True).env.production:模拟生产环境(如API_URL=https://api.example.com,DEBUG=False)- 在
.gitignore中明确忽略.env*,仅保留.env.example作为模板供新人参考
验证环境变量是否生效
最直接的方式是运行一个简单脚本查看实际加载结果:
import os
print("ENVIRONMENT:", os.getenv("ENVIRONMENT"))
print("API_URL:", os.getenv("API_URL"))
print("DEBUG:", os.getenv("DEBUG"))
用配置好的 Build System 运行该脚本,输出应匹配你当前激活的 .env.* 文件内容。若为空,检查文件路径是否在项目根目录、文件名是否拼写正确、插件是否已安装并重启 Sublime。
基本上就这些——不需要改 Sublime 源码,也不用外部 shell 包裹,靠插件 + 构建系统就能干净地分环境管理变量。










