墨穗app.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v1.0.165 · 墨穗笔记
笔记

Notebase墨穗
静水流深,落墨成穗。

0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →

笔记

0
加载中...

工具

0

此页用于记录用户反馈问题后的每一次改进

关于

笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

不想公开、只想临时给人看:点“分享”生成一条带密码和有效期的链接,到期自动失效,你也能随时撤销。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势

// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

watchexec

terminal

watchexec — 文件一改就自动跑命令,省去反复手动触发的麻烦。

如果你写过代码、跑过构建、编译过文档,大概率经历过这样的场景:改一行代码,切回终端,按上箭头,回车,等结果,发现报错,再改,再切,再回车……循环到怀疑人生。更崩溃的是,有时候你忘了手动触发,调试了半天才发现“哦,我还没重新跑”。

Watchexec 就是来解决这个痛点的。它监控你指定的文件或目录,一旦检测到变化(保存、新增、删除、重命名),立即自动执行你设定的命令。而且它跨平台——macOS、Linux、Windows 都能用,不需要依赖 inotify、fsevents 这类系统级工具,开箱即用。

它能干什么,解决什么问题

简单说,Watchexec 是一个“文件变化触发器”。你告诉它“盯着这个文件夹”,再告诉它“文件变了就运行这条命令”,剩下的事它全包了。

具体场景包括:

  • 自动重启开发服务器:比如你在写一个 Node.js 后端,每次改完代码自动跑 node server.js,不用手动 Ctrl+C 再重启。
  • 自动编译:写 Rust 项目时自动执行 cargo build,写 LaTeX 时自动 xelatex main.tex。
  • 自动运行测试:保存测试文件后自动执行 pytest 或 cargo test,第一时间看到红绿。
  • 自动刷新静态网站:配合 Hugo、Jekyll 等静态生成器,文件保存后自动重新生成页面。
  • 批量处理任务:比如监控图片文件夹,有新图片就自动压缩、上传。

和同类工具(比如 nodemon、entr、fswatch)相比,Watchexec 最大的优势是通用性:它不绑定任何语言或框架,任何命令行工具都能驱动。而且它处理信号传递非常干净,不会出现子进程残留的问题。

下载方式

官网在这里,所有下载链接都在首页就能找到:

Watchexec 官网

如果你喜欢直接去 GitHub 看 release,也可以去:

GitHub Releases 页面

安装方法

安装方式很灵活,挑你顺手的来:

macOS(Homebrew)

brew install watchexec

Linux(包管理器)

  • Ubuntu/Debian:sudo apt install watchexec(如果官方源没有,先加仓库,或者用下面 cargo 方式)
  • Arch Linux:sudo pacman -S watchexec
  • Fedora:sudo dnf install watchexec

Windows(Scoop / Chocolatey)

scoop install watchexec
# 或者
choco install watchexec

通用方式(Rust 的 cargo)
如果你有 Rust 环境,一行搞定:

cargo install watchexec-cli

直接下载二进制
去官网或 GitHub Releases,找到对应系统的压缩包,解压后把可执行文件扔到 PATH 目录里(比如 Linux 的 /usr/local/bin,Windows 的 C:\Windows\System32)。

基础使用教程

先来几个最常用的例子,感受一下。

例子 1:监控当前目录所有文件,文件变化时运行 echo "changed"

watchexec echo "changed"

保存任何一个文件,终端就会打印“changed”。这是最简单的验证方式。

例子 2:监控特定扩展名文件,变化时运行脚本

watchexec -e js,ts -- node build.js

只监控 .js 和 .ts 文件,其他文件变动不触发。

例子 3:监控某个子目录

watchexec -w src -w tests -- cargo test

只盯着 src 和 tests 两个目录,其他地方随便改都不管。

例子 4:延迟触发(防抖)

watchexec --debounce 500ms -- cargo check

你连续保存文件时,它会等 500 毫秒内没有新变化才执行。避免你疯狂按 Ctrl+S 时反复触发。

例子 5:忽略某些文件或目录

watchexec --ignore node_modules --ignore "*.log" -- npm run build

忽略 node_modules 目录和所有 .log 文件,其他变化都触发构建。

例子 6:只监控文件变化,不监控新增/删除

watchexec --watch . --on-modify -- cargo run

默认情况下,新增、删除、修改、重命名都会触发。加上 --on-modify 就只响应修改事件。

例子 7:传递信号给子进程(比如重启服务器)

watchexec --restart --signal SIGTERM -- python server.py

--restart 表示先终止旧进程再启动新进程。--signal 指定发什么信号,默认是 SIGTERM,也可以改成 SIGKILL。这对开发 web 服务器非常有用:每次改代码,服务器自动重启,你甚至感觉不到中断。

进阶技巧

1. 结合 clear 命令,每次执行前清屏

watchexec --clear -- cargo run

每次触发时先清屏,输出更清爽。也可以写成 --clear=reset,效果类似。

2. 使用 Shell 管道和复杂命令
如果你要执行多条命令,用引号包起来:

watchexec -- "npm run build && npm run deploy"

注意:Windows 上用 & 代替 &&,或者用 PowerShell 的 ;。

3. 处理大量文件变化的“节流”
有时候一次 git pull 或批量复制会触发成百上千次变化。用 --debounce 合并事件,同时用 --no-video(如果支持)减少日志:

watchexec --debounce 2s --no-meta -- echo "bulk change detected"

--no-meta 忽略元数据变化(比如权限、时间戳),只关注内容。

4. 只监控特定文件名模式
除了 -e 按扩展名过滤,还可以用 --filter 写更复杂的规则:

watchexec --filter "*.rs" --filter "!target/*" -- cargo build

! 开头表示排除。规则支持 glob 模式。

5. 在后台运行,并记录日志

nohup watchexec --restart -- node app.js > watchexec.log 2>&1 &

然后你可以关掉终端,它仍在后台跑。适合服务器环境。

6. 与 Tmux / Screen 配合
在 Tmux 里开一个窗格跑 Watchexec,另一个窗格写代码。保存文件后,自动触发,你立刻看到结果。比 IDE 内置终端还顺手。

7. 监控远程文件(通过 SSHFS / NFS)
Watchexec 支持监控挂载的文件系统。如果你在本地用 SSHFS 挂载了远程目录,直接 watchexec -w /mnt/remote 即可。注意网络延迟,--debounce 设大一点。

小提醒

  • 不要监控整个 node_modules:除非你想体验 CPU 100% 的酸爽。用 --ignore 排除掉。
  • Windows 用户注意路径分隔符:用反斜杠 \ 或正斜杠 / 都行,但建议统一用正斜杠避免转义问题。
  • 信号处理:如果你要终止 Watchexec 本身,按 Ctrl+C 即可。它会先向子进程发信号,再退出,不会留下孤儿进程。

总结

Watchexec 是一个“无废话”的工具。它不像一些重量级构建工具那样自带文件监听功能,但正因为轻量和通用,反而能适配几乎所有场景。无论你是写 Python、Go、Rust、JavaScript,还是处理 Markdown、LaTeX、图像文件,它都能成为你工作流里的“自动按钮”。

下次再手动按上箭头回车时,想想:是不是该让 Watchexec 帮你干了?

相似推荐
MetasploitPastaHashcatWezTermDenotig
编写使用方法
Markdown 格式 · Ctrl+Enter 确定
0 字新建笔记
欢迎回来
登录你的墨穗笔记账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属墨穗笔记
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

隐私提醒

取消
编辑工具
受控分享
为这篇笔记生成限时 / 带密码的临时链接
关闭