需手动设置vagrantfile语法为ruby：右键文件标签→set syntax→ruby，再view→syntax→open all with current extension as…→ruby；或在首行添加# -- mode: ruby --；并安装官方ruby语法包以支持vagrant dsl高亮。
Sublime Text 识别不了 Vagrantfile 的 Ruby 语法怎么办
默认打开 Vagrantfile 是纯文本高亮，config.vm.network 这类 DSL 全黑底白字，没缩进提示、没自动补全——不是插件坏了，是 Sublime 没把它当 Ruby 文件。
- 最直接有效：右键文件标签 → Set Syntax → Ruby；再点 View → Syntax → Open all with current extension as… → Ruby（注意是“current extension”，
Vagrantfile没扩展名，这步靠的是文件名匹配） - 加 modeline 更稳妥：
# -*- mode: ruby -*-写在文件第一行（星号和空格不能错），Sublime 3/4 都认；旧版可试# vim: set ft=ruby : - 别只靠内置 Ruby 语法：通过 Package Control 安装官方
Ruby语法包（不是 “Ruby on Rails”），它支持VagrantDSL 关键字如config.vm.synced_folder高亮
SFTP 插件连 Vagrant 总失败，端口 2222 有时通有时不通
SFTP 插件里硬写 "port": "2222" 是典型误区。Vagrant 默认用随机端口映射 SSH（除非你显式固定），vagrant reload 后可能变成 2201、2205……配置就失效。
- 推荐做法：在
Vagrantfile里固定 SSH 端口，加这一行：config.vm.network "forwarded_port", guest: 22, host: 2222, id: "ssh" - 更灵活方案：执行
vagrant ssh-config，复制输出里的Port和IdentityFile字段，填进sftp-config.json；HostName别写死127.0.0.1，用命令输出的值（可能是localhost或具体 IP） - 私钥路径必须绝对路径，Windows 用户注意斜杠方向：
"ssh_key_file": "C:/Users/xxx/.vagrant/machines/default/virtualbox/private_key"，且文件权限设为600
想本地写代码、自动同步到 Vagrant 虚拟机，但 synced_folder 不生效
不用装 SFTP、不写 rsync 脚本，Vagrant 原生共享文件夹就能跑起来——前提是 synced_folder 配置对了，且 Guest Additions 正常。
- 检查
Vagrantfile中是否启用：config.vm.synced_folder "./", "/vagrant", type: "virtualbox"（Linux/macOS）或type: "rsync"（Windows 推荐） - 确保 VirtualBox Guest Additions 已安装：
vagrant up时看日志有没有Checking for guest additions成功提示；没有就手动vagrant plugin install vagrant-vbguest - Windows 用户慎用
type: "virtualbox"：容易因权限或路径分隔符出问题，优先改用type: "rsync"，并确认已安装 rsync（Git Bash 自带） - 修改后必须
vagrant reload，不是vagrant up—— 只有 reload 才重载 synced_folder 配置
Anaconda 插件在 Vagrant 环境里找不到 Python 解释器
Anaconda 默认查本地 python，而 Vagrant 项目实际运行在虚拟机里。不告诉它去哪找，goto definition、linting 全挂掉。
- 打开项目根目录下的
.sublime-project，在"settings"里加："anaconda_python_interpreter": "/vagrant/venv/bin/python"（路径按你虚拟机里实际位置填） - 如果用的是系统 Python（非 virtualenv），路径通常是
/usr/bin/python3或/opt/centos/python3/bin/python3，先vagrant ssh进去which python3确认 - 别依赖 Anaconda 自动探测：Vagrant 启动后 IP 动态变，Anaconda 不会主动刷新远程解释器地址；每次
vagrant reload后，记得检查 project settings 里路径是否还有效
Vagrantfile 语法高亮、SFTP 端口、synced_folder 类型、Anaconda 解释器路径——这四点卡住的人最多。它们看起来是配置项，实则是环境链路上的关键锚点：一环松动，整个本地开发流就断在编辑器里。
