Eclipse 运行命令行参数大全
运行 Eclipse3 b. {) b3 ?6 M, ?$ x
将 Eclipse 驱动程序安装(解压缩)到某个目录(例如,c:\eclipse)中之后,通过运行2 J, M, b2 y+ I. c
* x7 k R! m0 W* Z- O% O7 j顶级安装目录中的 Eclipse 可执行文件来启动"工作台"。在 Windows 系统上,该可执行9 C' ^8 H9 [. C
. W* H+ V' m; P/ `3 W文件称为 eclipse.exe,而在 Linux 系统上称为 eclipse。注意:下列讨论描述 Windows 9 P- D9 j* D1 N9 p1 P( m4 X, ^8 r
" d( E; E- g$ C. z1 K7 H: m6 S: n$ p
系统上的设置。Linux 上的设置是相似的。
9 c4 L8 n% { o9 p* |! B" [, g- |/ Y7 v% |
如果您没有另行指定,则平台将缺省工作区目录创建为可执行文件的兄弟目录(例如 ; _# ~( y$ Z, L; ^5 {! S- d
: j0 c( }. E2 I
c:\eclipse\workspace)。此工作区目录用作项目的缺省内容区,还用于保存任何必需的
) x+ @( Q- N( K |# k7 I% Y8 }4 l& _' b
元数据。要进行共享安装或多工作区安装,应明确指出工作区的位置而不是使用缺省值。
6 P( k2 f: `/ V: z% b' ]0 s3 K X. I+ h- v: K" K, T
有两种控制工作区位置的方法:使用当前工作目录或使用 -data 命令行自变量。9 J7 _/ ]; B' v
. T" W# u1 e1 i8 Q& V+ g
将工作区位置设置为在当前工作目录内
$ O5 \# ^+ X( L6 t
. k0 V" z+ D2 A* U I, X. e5 M在此方案中,工作区位置将是当前工作目录中称为 workspace 的目录。
( L. m w' s0 H) `4 U( f: B5 k- m K+ M7 |
实现此目的最容易的方法可能是使用下列步骤来创建快捷方式:
6 A/ l, O* N3 z. C: S* v# c8 Z
; Y" C9 n1 o6 m导航到 Windows 资源管理器中的 eclipse.exe 并使用右键拖动来创建 eclipse.exe 的快捷方式。 7 p* W% k) o) u. F9 O
, Z! D* k; X9 V& z; N9 f编辑快捷方式的属性,以使启动位置:字段标识工作区位置的父目录(例如,c:\users\robert)。. T9 J6 ]2 f- ^% C5 z
5 \$ R5 j. E9 c( l, f1 R. y关闭属性对话框并双击快捷方式(如果提供的目录为 c:\users\robert,则工作区位置将为 c:\users\robert\workspace)。* I& ~8 d/ _( u' t3 R* A
M! B- c5 X& @( C3 g! o2 i! \当然,您也可以使用命令提示符(通过将目录切换为工作区父目录然后运行 eclipse.exe)来获得同样的效果。
: [3 `; d( b7 w' N3 g9 B1 b" W/ B) P* a' P
使用 -data 设置工作区的特定位置
1 l6 F8 W0 ~8 W" c, U! W1 d
3 P& F! b* ^, l* Z" d要使用 -data 命令行自变量,只要将 -data your_workspace_location(例如,-data
" r/ [5 m) Z! H. d
, o( G: s0 J" zc:\users\robert\myworkspace)添加至快捷方式属性中的目标字段或显式地将它包括在命令行上。
$ q) F; \7 o7 |( t t% e/ K3 I0 q. m
使用 -vm 设置 java VM
- m9 T* p. N" r: {4 e' J$ Q; a( V9 @4 m建议显式指定在运行 Eclipse 时要使用哪个 Java VM。使用 -vm 命令行自变量(例如,
. X7 U. I0 K5 f7 f" z+ d( i8 t k9 d7 L: _7 L. e% g
-vm c:\jre\bin\javaw.exe)可以实现此目的。如果不使用 -vm,则 Eclipse 将使用在 ( o# S; f- q u+ @4 A
$ p- d6 h8 Q6 M/ c; O% K) fO/S 路径上找到的一个 Java VM。当安装其它产品时,它们可更改您的路径,导致在下
2 {( z% r z: q4 Y3 p9 q9 B2 P
8 }2 C2 z3 h4 l一次启动 Eclipse 时使用另一 Java VM。
8 p9 o) ?1 v' H
1 F$ L7 Z' c) y7 @8 R' ~运行 Eclipse 中的高级主题
/ d! E" G4 Q t7 y/ H% m0 A
% b: ]+ D6 k8 F6 a6 tEclipse 可执行文件及平台本身提供了人们感兴趣的开发或调试 Eclipse 各部件的许多执行选项。
1 H: D( \) k0 B* q
l) U/ s& f& @运行 Eclipse 可执行文件的一般格式是: \, I* v0 R! a e, e/ O
6 `" z S+ l- T
eclipse [platform options] [-vmargs Java VM arguments ]+ W: t( ^* L8 O' q q7 x
' I4 L& [* q! z9 w; ]# Z7 i0 t
Eclipse 启动参数 命令 描述 原因 ' K" v7 K) l6 \% ~2 ~/ e' j( P
. C3 V6 U" K7 r$ t# J
-arch architecture
E) J8 H2 q4 R$ H6 F0 u7 i! A9 B" ~8 d
定义 Eclipse 平台在其上运行的处理器体系结构。Eclipse 平台通常使用 Java os.arch 属# X' P x: _6 R1 ^7 f, s
: P2 e' {# g! z. H性的常用值来计算最佳设置。如果在此处指定该项,则这是 Eclipse 平台使用的值。此处
2 f d/ Q1 X7 U/ H4 t3 }0 M9 u- Y+ w" g! Y6 H) h @% k0 y
指定的值可作为 BootLoader.getOSArch() 用于插件。示例值有:"x86"、"Sparc"、"PA-RISC"和"ppc"。 2.0 : L8 _) I: D" `9 G/ S" l: K
6 j3 M- L7 u& }0 O/ X/ U/ x3 c' U1 n9 O
-application applicationId要运行的应用程序。- C B% {3 i4 O
/ g5 ?* x; E6 Q" E* W) L
应用程序由向 org.eclipse.core.runtime.applications 扩展点提供扩展的插件来声明。
. |3 s, y o" F4 K+ j0 v* A7 ]! j, D, y/ d% Z. c, q# S6 ?
通常不需要此自变量。如果指定了此项,则该值会覆盖配置提供的值。如果不指定此项,则会运行"Eclipse 工作台"。 1.0
0 ]. V9 N: n1 h6 w& P) d l-boot bootJarURL
& R9 n; Z+ Y5 N x H9 P& U(建议不使用;用 -configuration 代替;支持 1.0 兼容)。Eclipse 平台的引导插件代码
- t0 P4 @( n: V* a8 t( b; S, b. r9 c/ w6 t2 _* H
(boot.jar)的位置,表示为 URL。如果指定此项,则会用它来为装入 Eclipse 平台引导9 i+ }) O2 c9 Z* s
. r0 O1 }4 i, O( Y程序类装入器的类装入器设置类路径。仅当更改 startup.jar 和 boot.jar 的相对位置时才5 F' j1 G! Q6 P. ?3 w
5 H$ Y U5 F5 P h. }3 D: L需要它。注意,不允许使用相对 URL。 *1.0 -classloaderproperties [file]
& ?9 f7 G/ i) @" L( D# \6 ?如果指定的话,则使用给定位置处的类装入器属性文件来激活平台类类装入器增强。文, v4 z) ? _! I& ?( f& L! u
3 Q7 F5 {7 O1 u件自变量可以是文件路径或 URL。注意,不允许使用相对 URL。单击此处以获得更多详细信息。 2.0.2 6 y3 U8 [4 A! M3 @8 B
-configuration configurationFileURL
" h2 @0 k/ a! C! q5 C; \Eclipse 平台配置文件的位置,表示为 URL。配置文件确定 Eclipse 平台、可用插件集和' y9 X- Q, f/ _0 p9 c) z l& d
" r2 X5 k5 H) t8 b* ~( I" X主要功能部件的位置。注意,不允许使用相对 URL。当安装或更新 Eclipse 平台时配置文4 D6 s1 d8 D6 i) P- N1 @9 h
; {! y: Z. e. r& i8 C
件被写至此位置。 2.0 3 p" G2 e$ B* ?
-consolelog
' [; _' n0 {$ |. F1 Y- u) U将 Eclipse 平台的错误日志镜像到用来运行 Eclipse 的控制台。与 -debug 组合时很方便 n9 H' a. F9 N
. m# I: Z; |2 \
使用。 1.0
. R1 w! T" F( x. k! O% e-data workspacePath
) |) q8 L6 V& [9 Z, F' k0 B要运行 Eclipse 平台的工作区的路径。工作区位置也是项目的缺省位置。相对于从中启动 1 q" X3 J7 ]9 q% N# a6 c
9 Y0 ~4 Z+ f9 b6 [; U! X; N w3 Weclipse 的目录来解释相对路径。 1.0
" T% Z9 u3 W" T6 v1 |-debug [optionsFile]
+ R7 [3 g1 Z( Y% L3 ~将平台置于调试方式,并从给定位置处的文件装入调试选项(如果指定的话)。此文件1 L) P. e& b P
/ b) l/ s, G/ ~6 K" o8 e
指示哪些调试点可用于插件以及是否已启用它们。如果未给出文件位置,则平台在启动 ) S' d6 E B0 M+ b, @
9 R: G4 B- t1 }
eclipse 的目录中查找称为".options"的文件。URL 和文件系统路径都可作为文件位置。 + I- O: _- G' Z2 k* @( x
; I( z7 h+ }0 ]% b4 i' P+ Y$ O8 e1.0
/ y9 X. r5 J# s. P* k# U3 d' u- s* @-dev [classpathEntries]* V" A, W: O6 z$ N9 H1 u
将平台置于开发方式。将可选类路径条目(用逗号分隔的列表)添加至每个插件的运行6 }8 a) A) i l) \
9 }2 U u+ R) R9 `, `- A6 @& o
时类路径。例如,当工作区包含要开发的插件时,指定 -dev bin 会为每个插件项目的名; I3 p8 d! K; U, J5 m
4 J! z L9 J/ U6 L. }& V
为 bin 的目录添加类路径条目,允许在其中存储最新生成的类文件。除去了冗余或不存# x0 }" {4 [- }5 v
, A4 n1 j+ @" i, l. k( D4 I
在的类路径条目。 1.0
8 W4 x/ ]! C2 B" `( P: o2 e-endsplash params
; r1 o5 K3 M0 |1 T0 L( y% w用于在 Eclipse 平台启动并运行时关闭闪屏的内部选项。此选项在闪屏处理链中不同的位6 H4 P8 m R0 {4 y7 z" v
% i3 Y+ O$ I9 Q7 _/ Z, |置有不同的语法和语义。 2.0 ; i4 ^1 H" _" N& U
-feature featureId. ^+ k( o/ {% c" S* R( q5 C* \
主要功能部件的标识。主要功能部件为 Eclipse 的已启动实例提供了产品个性,并确定使
! L0 j! e) C& T5 {3 R
' S8 d0 q; b0 }1 Y0 Y用的产品定制信息。 2.0
4 w) ^3 A5 y! O& l4 J-keyring keyringFilePath
6 p" w: @% J4 M. K/ X磁盘上授权数据库(或"密钥环"文件)的位置。此自变量必须与 -password 选项配合使用0 ]. v" P5 s8 w$ [3 a
- U/ P* V/ ^$ Y1 ^* M。相对于从中启动 eclipse 的目录来解释相对路径。 1.0 " o* ~8 z; l2 ~ ~ e
-nl locale5 n1 u0 K7 e9 l3 l
定义 Eclipse 平台在其上运行的语言环境的名称。Eclipse 平台通常自动计算最佳设置。
* ^* z2 D! a6 K. Y; c8 g8 o
5 K" S* p* q \如果在此处指定该项,则这是 Eclipse 平台使用的值。此处指定的值可作为 2 g$ F ? x/ K. z8 f1 ^
- P. R8 o( y J( j
BootLoader.getNL() 用于插件。示例值有:"en_US"和"fr_FR_EURO"。 2.0
" u/ L7 x' N2 {-nolazyregistrycacheloading
) @1 u, w. X# F! q0 x% t取消激活装入优化的平台插件注册表高速缓存。缺省情况下,仅当需要时才从注册表高
% d- R5 [9 t) H& Z
: q& k3 R) w. l9 \4 ]速缓存(可用时)中装入扩展的配置元素,以减少内存占用。此选项将在启动时强制完1 A) J3 s8 s! Y) e F# R" k3 A
2 Y, ^5 e/ \* a3 p4 T全装入注册表高速缓存。 2.1 " c( r# q5 z7 o i. u- {& L! `
-noregistrycache9 p+ C9 A+ @. {$ y2 j0 O* S! U
绕过读写内部插件注册表高速缓存文件。 2.0 . i& ]$ S. M5 p& g0 F
-nosplash- _4 g/ r5 j/ Y9 j9 I
运行平台而不显示闪屏。 1.0
1 [( [/ A6 N4 J4 C. {-os operatingSystem
9 t* H+ A# a/ A, M定义 Eclipse 平台在其上运行的操作系统。Eclipse 平台通常使用 Java os.name 属性的. u1 g1 _" ]3 q7 q
: w0 l+ J6 |; ]% _8 J常用值来计算最佳设置。如果在此处指定该项,则这是 Eclipse 平台使用的值。此处指定1 `6 o$ o, l5 ~) ?* `: @0 F
# X: Y0 k. M' L: }) t" C的值可作为 BootLoader.getOS() 用于插件,并用于解析插件清单文件中提及的路径中 2 [3 ^; ]+ R, K0 l; ~6 G$ X
5 e9 C. C5 ^' W# k" t9 \$os$ 变量的出现。示例值有:"win32"、"linux"、"hpux"、"solaris"和"aix"。 1.0 0 d' ~: _6 B9 S* F* N" w
-password password$ ^8 Z5 g+ x/ ?8 t
授权数据库的密码。与 -keyring 选项配合使用。 1.0 : q6 i0 d7 U: f( f# `4 s
-perspective perspectiveId
. M" B9 ^. e" F/ B7 q' _ g5 N启动时要在活动工作台窗口中打开的透视图。如果没有指定该参数,则将打开关闭时活3 X4 V+ L& ^- H) x- m8 H: Z* ]
3 G, P) n& D6 P) N动的透视图。 1.0 ]$ j" }' H0 r
-plugincustomization propertiesFile
- P8 Q* {; K% @2 u, g包含插件首选项缺省设置的属性文件的位置。这些缺省设置覆盖在主要功能部件中指定5 B7 j2 X+ W0 K. f3 D
; h3 Q: }3 t/ C+ U8 h) b" Q- o$ J的缺省设置。相对于从中启动 eclipse 的目录来解释相对路径。 2.0
/ _ [, Q. z7 @' _-plugins pluginsFileURL, |: T, ^4 ^# Y/ `, u
(建议不使用;用 -configuration 代替;支持 1.0 兼容)。 指定 Eclipse 平台查找插件
! S# y: X, ?* a8 C0 o2 \ D* r* T! b9 ~( I/ T
的文件的位置,表示为 URL。该文件为属性文件格式,其中键是任意用户定义名称,值 T# `- O3 C! P1 f& \
5 \0 l1 z; N$ x$ `, T是指向 plugin.xml 文件的显式路径或指向包含插件的目录的路径的用逗号分隔的列表。
/ O$ A$ _! D8 }/ b4 V) L" n2 a
2 _7 M O5 l- p: b8 O5 |2 c注意,不允许使用相对 URL。如果指定此项,则此选项会导致创建适当的临时配置。
! E$ M s8 L7 ?( U+ `; R' H' y* y. K# K9 f' m! o
*1.0
" @! k; g+ X- _1 N2 Y( a-refresh
6 Q# K F1 E; U/ c" s启动时执行工作区的全局刷新的选项。这将使从上次平台运行以来在文件系统中所做的
, K, w' [7 l% X7 d, b5 @/ W
$ f- Q6 G) V" b- d. m' F+ j任何更改一致。 1.0 1 D, ]/ `# m2 x- V
-showlocation - H$ q/ c1 p* d( Z4 o6 [2 p
用于在窗口标题栏中显示工作区的位置的选项。在发行版 2.0 中,此选项仅与 -data 命
/ c/ k7 [0 }1 J% Y3 Q7 O& m+ U- M& h7 X' z) o/ e
令行自变量一起使用。 2.0
2 @; Y: m+ N' Y-showsplash params
/ _6 L1 }2 l. T3 b" [用于显示闪屏(由可执行的 Eclipse 平台启动器执行)的内部选项。此选项在闪屏处理链4 n; b3 B. ]" ~: }3 ?
. T' `- J+ h# K, }/ O9 j) {1 l中不同的位置有不同的语法和语义。 2.0 3 a/ m6 Z4 c0 ?0 G
-vm vmPath
; B% o2 ~% l" H( J/ u/ X$ J要用来运行 Eclipse 平台的"Java 运行时环境"(JRE)的位置。如果不指定此项,则 JRE
, c/ F+ r9 r/ V$ o6 q
+ t9 {" F1 c6 l7 `6 Z2 U5 i$ J. ?位于 jre(它是 Eclipse 可执行文件的兄弟目录)。相对于从中启动 eclipse 的目录来解
0 r' n9 a" ~. j+ B; ~. q" z$ ]8 t9 e) \+ Q6 z+ i" Y. ~/ v
释相对路径。 1.0 " ?+ |3 B9 N% ^6 ]2 C) L" M0 i( r' S( Y. z
-ws windowSystem- Y Y+ B2 @) L# b
定义 Eclipse 平台在其上运行的 Windows 系统。Eclipse 平台通常使用 Java os.name 属
' y" `3 T. T4 h% C1 y" l4 T8 s2 U% N4 g6 L( T
性的常用值来计算最佳设置。如果在此处指定该项,则这是 Eclipse 平台使用的值。此处8 _6 C+ A" Q% N2 v" {# l
; Y- o1 x6 W( t2 {9 H4 i: F指定的值可作为 BootLoader.getWS() 用于插件、用于配置 SWT 以及用于解析插件清单
. W5 N9 |3 U' T% {9 w" ~! U* b. K) z" Y. p$ `% S
文件中提及的路径中 $ws$ 变量的出现。示例值有:"win32"、"motif"和"gtk"。 1.0
! v0 j' o7 [! `4 y8 S7 T: t. e" W% p% y( J3 V( r
将 -vmargs 条目后面的所有自变量(但不包括 -vmargs)作为虚拟机自变量(即,在要( g! }1 d% S+ [( e# F) p' `
( \4 l+ \$ D) g5 B" i9 }
运行的类的前面)直接传递到所指示的 Java VM。注意:如果 Eclipse 启动在 Java vm
1 W3 `# ?5 t' l2 B+ N) n1 g# q1 w! e7 Y! [( K4 k
自变量(-vmargs)之后提供的自变量(例如,-data),则 Eclipse 将不会启动并且您将; l, F5 }) _$ J4 o+ M$ \5 R
4 Z" ?3 q3 A9 W/ _7 P/ P- F- F
接收到"JVM 已终止。出口代码为 1"的错误。& _& j# j: C. M. f9 k
6 r" @4 n7 D+ m在不同的 VM 上运行
4 e5 H! ]; f/ T在 J9 上运行 Eclipse7 P* M# v4 P4 ] [: E
当在 J9 版本 1.5 上运行 Eclipse 时,建议使用以下 VM 选项:
! y* u* L3 h$ K, z8 a% s+ }7 Y0 V6 P) P) m" F7 P. h W
eclipse.exe [eclipse arguments] -vm path_to_j9w.exe -vmargs -ms:32 -
# H# F# A, R9 X' K0 J# Y) \- u9 N+ _& l0 a# N
mm:2048 -mo:32768 -moi:32768 -mca:32 -mco:128 -mx:2000000 _8 k- n7 R0 T3 E8 H% L! a0 d( n
当在 J9 版本 2.0 上运行 Eclipse 时,J9W 选择的缺省自变量应为合适的选项。但是,要
6 l/ O! {: A1 _) B7 _0 Q2 \- T: q" Q! i8 `2 i
覆盖 Eclipse 可执行文件以内部方式自动设置的参数,必须指定 -vmargs 不带任何参数,如下所示: 3 H" x/ W: G2 z+ e! y
! ~) p% F4 ]& |3 _ i& {0 T0 Qeclipse.exe [eclipse arguments] -vm path_to_j9w.exe -vmargs) @: g1 Y3 y, V( k% h
有关进一步信息,参考 J9 VM 文档和帮助。; z+ `/ i; w% _
% u3 }" L7 a1 c9 W" j. e
在 IBM Developer Kit, Java(TM) Technology Edition VM 上运行 Eclipse/ N1 l1 Z- {2 l
IBM Developer Kit, Java(TM) Technology Edition 1.3 Linux 的缺省 VM 设置适合进行初, V: g( _5 K' A2 t4 Q
5 x9 C" @% p# y# o& |
期研究工作,但在进行大型开发时是不够的。对于大型开发,应修改 VM 自变量以使有: ^, h9 a) F: l. ^8 ^( @9 s
. j2 q5 j; v2 M" y更多的堆可用。例如,下列设置将允许 Java 堆增大为 256MB:. k1 z! [6 t O/ c: ?* p6 }( W/ s
. H$ z5 q1 C J
-vmargs -Xmx256M