如何使用Sublime Text 4的AdvancedNewFile插件高效生成新文件？

本文共计835个文字，预计阅读时间需要4分钟。

在Sublime Text 4上，无法直接使用Package Control安装原版AdvancedNewFile插件，必须手动安装社区维护的分支版本。否则，会报错TypeError: expected string or bytes-like object或快捷键无响应。具体分支版本为：

为什么 Package Control 安装的 AdvancedNewFile 在 ST4 上失效

原作者已停止维护，Sublime Text 4 的 API 变动（尤其是 view.window() 返回值、路径解析逻辑和命令执行机制）导致老版本崩溃。常见现象包括：

• 按下 Ctrl+Alt+N（Windows/Linux）或 Cmd+Alt+N（macOS）后无反应
• 控制台报错 TypeError: expected string or bytes-like object
• 输入路径后提示 “Path does not exist”，但目录实际存在

Package Control 搜索 “AdvancedNewFile” 默认返回的是已下架的老版本（作者 skuroda），不是 ST4 兼容版。

正确安装 AdvancedNewFile_ST4 的步骤

必须跳过 Package Control，手动安装社区维护分支 rbharrin/AdvancedNewFile_ST4：

• 关闭 Sublime Text
• 进入插件目录：
  • macOS：~/Library/Application Support/Sublime Text/Packages/
  • Windows：%APPDATA%\Sublime Text\Packages\
  • Linux：~/.config/sublime-text/Packages/
• 克隆仓库：git clone --depth 1 https://github.com/rbharrin/AdvancedNewFile_ST4.git AdvancedNewFile（注意目录名必须是 AdvancedNewFile）
• 重启 Sublime Text
• 按 Ctrl+Shift+P 输入 AdvancedNewFile: Create File，确认命令可触发

路径输入必须遵守的三条铁律

插件对路径格式极其敏感，错一个字符就建错位置甚至失败：

• 一律用正斜杠 / 分隔路径，Windows 下也别用 \ —— 输入 src\utils\index.js 会被当作文本文件名，真实创建一个叫 src\utils\index.js 的怪文件
• 不加 / 开头 = 相对于当前打开的文件所在目录；加 / 开头 = 相对于项目根目录（前提是已通过 File → Open Folder… 加载项目，且该目录出现在侧边栏）
• 路径中含空格或中文时，必须用英文双引号包裹，如 "my plugin/index.js"；不推荐用单引号或中文引号

默认自动建目录，但有个致命前提

AdvancedNewFile_ST4 默认开启 create_intermediate_directories，输入 src/api/v1/users.js 会逐级创建 src/ → src/api/ → src/api/v1/ 再写入文件。但这只在以下条件下生效：

• Sublime 必须已加载一个项目文件夹（即侧边栏顶部显示的是你项目的根目录）
• 如果只是用 subl some-file.js 打开单个文件，插件无法推断根路径，会静默失败或 fallback 到 $HOME
• 中间目录若因权限不足（如 NFS、Docker volume、杀毒软件拦截）无法创建，插件不会提示具体哪一级失败，只会卡住或报 “Permission denied”

最常被忽略的一点：插件不检查 .gitignore，node_modules/foo.js 照样能建，不会警告——你得自己负责别手滑输错路径。