讲师中心 微信公众号
AI工具推荐 视频效率加速

PhpStorm怎么设置忽略上传部分文件夹_过滤node目录不将其当作部署文件【技巧】

冬芳小哥_6689

冬芳小哥_6689

发布时间:2026-05-30 06:08:47

|

208人浏览过

|

来源于php中文网

原创

Deployment上传node_modules是因排除规则配错位置;需在Tools > Deployment > Configuration > Options的Exclude items by name中填入node_modules/(带斜杠),而非.gitignore或Ignored Files and Folders。

phpstorm怎么设置忽略上传部分文件夹_过滤node目录不将其当作部署文件【技巧】

Deployment 上传时 node_modules 还在传?不是没忽略,是配错了地方

WebStorm / PhpStorm 的「忽略」分三套系统:索引、Git 提交、Deployment 上传。只在 .gitignore 里写 node_modules/,或只在 Ignored Files and Folders 里加 node_modules,对上传行为完全无效。

Deployment 是独立通道,它不读 IDE 索引设置,也不看 Git 配置。哪怕 node_modules 已灰成背景板、Ctrl+Click 跳不进去、搜索也搜不到——只要没在 Deployment 的排除规则里明确写上,它照传不误。

  • 打开 Tools > Deployment > Configuration
  • 切到 Options 标签页
  • 在 Exclude items by name 输入框中填入:node_modules/, dist/, .env.local, *.log(逗号分隔,支持通配符)
  • 注意斜杠:写 node_modules/ 表示排除该目录及其全部子内容;写 node_modules(无斜杠)可能只匹配同名文件

为什么 Mark as Excluded 对上传没用?它只管本地,不管远程

Mark Directory as > Excluded 是项目级语义标记,作用域仅限于本地索引、跳转、补全和重构范围。它会让 node_modules 在 Project 面板变灰、右键菜单消失、状态栏提示 Indexing paused for excluded files——但 Deployment 功能压根不认这个状态。

常见错觉:标完 Excluded 就以为“已经安全了”,结果上线前一同步,node_modules 被完整推到服务器上,不仅浪费带宽,还可能覆盖线上 vendor 或触发权限错误。

立即学习“PHP免费学习笔记(深入)”;

Github Stars Analyzer
Github Stars Analyzer

抓取指定 GitHub用户的 Stars 项目,生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...

下载
  • Excluded 写进 .idea/{project}.iml,只影响当前项目本地行为
  • Deployment 排除规则存在 .idea/deployment.xml(或配置界面),两者完全隔离
  • 如果用了多环境部署(如 dev/staging/prod),每套环境的 Exclude items by name 都得单独检查一遍

排除 dist/ 或 build/ 后,前端资源却访问不到?检查是否误删了入口

前端项目常把构建产物放在 dist/,然后通过 Nginx 指向它。若你在 Deployment 中排除了 dist/,又没手动上传过一次,线上就真没这个目录——浏览器直接 404。

这不是配置失败,而是逻辑冲突:你既想“不自动上传构建产物”,又希望“线上有可用静态资源”。必须明确区分「谁负责生成」和「谁负责发布」。

  • 若构建在本地完成:上传前手动勾选 dist/ → 右键 Upload to …,跳过全局排除规则
  • 若构建在 CI 完成:Deployment 排除 dist/ 是对的,但要确保 CI 脚本把产出推到对应远程路径
  • 别在 Exclude items by name 里写 index.html 这类关键入口,否则整个站点不可访问

多个排除规则叠加时,优先级和递归行为怎么算?

Deployment 的排除是递归且无条件的:一旦路径匹配 Exclude items by name 中的任意模式,该路径及其所有子孙内容均被跳过,不参与任何上传、下载、同步操作。

但要注意规则之间不叠加生效,而是“命中即停”——没有“先排除 A 再包含 B”的白名单机制。比如你写了 node_modules/, node_modules/@types/,后一条完全多余;写了 dist/, dist/index.html,第二条也不会让 index.html 恢复上传。

  • 模式匹配不区分大小写,但路径需严格对应(DIST/ ≠ dist/)
  • 不能用正则,只支持 * 和 ?:例如 *.tmp, logs/**/*.log(部分旧版不支持双星号,建议用 logs/*)
  • 若同时配置了「项目创建时排除」和「Options 里排除」,以后者为准;修改后需点击 Apply 才生效

最易被忽略的一点:Deployment 排除只作用于你主动触发的上传/下载/同步动作,不影响 WebStorm 自动保存时的后台同步(如果开启了 Auto-upload)。所以关掉 Auto-upload 或确认其排除规则已同步更新,比单纯加一行 node_modules/ 更关键。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
phpstorm怎么导出项目
phpstorm怎么导出项目

phpstorm提供导出项目功能,步骤如下:打开phpstorm项目转到“项目”菜单选择“导出项目”选择导出格式指定导出位置选择导出范围勾选“包括依赖项”框(可选)单击“导出”完成导出。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1288

2024.04.08

phpStorm怎么运行
phpStorm怎么运行

本专题整合了phpstorm运行教程,阅读专题下面的文章了解更多相关内容。

5258

2025.09.18

phpstorm开发环境搭建教程
phpstorm开发环境搭建教程

本专题整合了phpstorm开发环境搭建和运行项目教程,阅读专题下面的文章了解更多详细教程。

5556

2025.09.18

phpstorm怎样运行php
phpstorm怎样运行php

本专题整合了phpstorm运行php相关教程,阅读专题下面的文章了解更多详细内容。

2061

2025.09.18

phpstorm相关教程大全
phpstorm相关教程大全

本专题整合了phpstorm相关教程汇总,阅读专题下面的文章了解更多详细内容。

118

2026.01.15

从环境搭建到代码调试:PHPstorm全流程开发配置指南
从环境搭建到代码调试:PHPstorm全流程开发配置指南

本文旨在为PHP开发者提供一份详尽的PhpStorm全流程开发配置指南。内容涵盖从IDE安装、PHP解释器配置、Xdebug调试环境搭建,到项目运行与断点调试的完整流程。通过本指南,读者将掌握搭建高效开发环境的核心技能,快速上手PhpStorm的强大功能,显著提升PHP开发效率。

81

2026.04.01

PHPstorm编辑器全系统安装与激活配置指南
PHPstorm编辑器全系统安装与激活配置指南

本文提供一份详尽的PHPstorm全系统安装与激活配置指南,覆盖Windows、macOS及Linux三大主流平台。内容从官方安装包的获取、安装过程中的路径与组件选择,到激活流程(包括正版激活与补丁替换法)均有详细图解。此外,指南还包含安装后的基础环境配置与中文语言包安装,旨在帮助开发者快速完成IDE部署,为PHP开发搭建一个稳定、高效的集成环境。

216

2026.04.01

ps软件新手入门教程合集
ps软件新手入门教程合集

PHP中文网精心打造了本PS新手入门教程合集。内容涵盖软件安装、界面认知、图层管理及抠图调色等核心技能,提供从零基础到精通的系统化学习路径。无论您是想快速上手修图还是进阶平面设计,都能在此找到实用指南与实战案例,助您轻松玩转Photoshop。

840

2026.06.11

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
安装 Xdebug 并配置 phpstorm
安装 Xdebug 并配置 phpstorm

共1课时 | 185人学习

3分钟内将Xdebug安装到PHP
3分钟内将Xdebug安装到PHP

共1课时 | 164人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn