vscode 中 node_modules 显示只读是因文件系统权限限制而非编辑器锁定；需检查属主和目录可写性，避免 sudo 安装，并通过项目级 files.readonlyinclude 配置实现安全只读控制。
VSCode 里打开 node_modules 文件却提示“无法在只读编辑器中编辑”，不是 VSCode 故意锁你，而是它在忠实地反映底层权限状态——文件系统不允许写，编辑器就只能降级为只读。真正要动的不是设置，是路径归属和编辑器行为策略。
为什么 node_modules 显示只读？先确认是不是真被系统锁死
VSCode 不会主动把 node_modules 标成只读，它只是读取文件系统返回的权限位。如果 ls -l node_modules/lodash/index.js 返回的是 -r--r--r--（没 w），或者属主是 root，那问题就在文件本身。
- 运行
ls -ld node_modules：看目录是否可写（drwxr-xr-x才行）；父目录不可写，VSCode 保存时重命名临时文件会失败 - 检查是否用过
sudo npm install或sudo code .：这会让部分文件属主变成root，普通用户无法覆盖 - 别信右键属性里的“只读”勾选框（Windows）：它对
node_modules这种深层嵌套目录基本无效，得进安全选项卡逐级赋权
files.readonlyInclude 是唯一靠谱的编辑器层防护
想让 VSCode 主动把 node_modules 下所有文件当只读看待，靠系统 chmod 不现实（会干扰包管理器），必须用 files.readonlyInclude 配置项，且必须写进项目级 .vscode/settings.json。
- 正确写法：
"files.readonlyInclude": { "**/node_modules/**": true }——双星号才能匹配任意层级子目录下的文件 - 如果项目用
pnpm，补上："**/.pnpm/**": true；用yarn@2+就加"**/.yarn/cache/**": true - 改完必须 重新加载窗口（
Ctrl+Shift+P→Developer: Reload Window），否则不生效 - 这个设置只影响编辑器 UI：禁用保存快捷键、显示 “Read-only” 水印，但不改变文件系统权限，不影响
npm、webpack等工具运行
千万别碰 chmod -R -w node_modules
给整个 node_modules 加只读权限看似一劳永逸，实际是埋雷：
-
webpack、ts-node、vite等工具会在node_modules里生成缓存或临时构建产物，只读权限会让它们直接崩溃 - macOS/Linux 下
chmod -R -w后，下次npm install可能报EACCES或静默失败 - Windows 上该命令基本无效，且可能触发 Defender 或 OneDrive 锁定文件
- VSCode 的
files.readonlyInclude是纯前端控制，不干涉任何命令行行为，这才是跨平台安全解法
插件和格式化器可能偷偷绕过只读限制
即使开了 files.readonlyInclude，某些插件仍可能在你不知情时修改文件：
-
Prettier在保存时自动格式化，会无视只读状态强行写入 —— 关掉editor.formatOnSave或在settings.json里加"prettier.enable": false -
GitLens在非 Git 工作区扫描时会临时打开并锁定文件，导致状态栏显示 Read Only —— 禁用后重启验证 - 确认没有启用
files.saveWithoutWatching（默认true），它会让 VSCode 绕过只读检查直接写磁盘
真正容易被忽略的点有两个：一是 files.readonlyInclude 必须写在项目 .vscode/settings.json 里，写进用户设置会被覆盖；二是所有配置变更后必须重载窗口，而不是简单关闭再打开 —— 后者不会刷新编辑器内核的路径匹配规则。
